Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.dench.dev/llms.txt

Use this file to discover all available pages before exploring further.

Use context commands whenever an agent needs to orient itself. They are safe read commands and should be part of every setup verification.

​
dench context

dench context shows the current workspace from the agent’s perspective. 
dench context
dench context --json
The human-readable output includes:
  • Active workspace and workspace slug
  • Current agent name and kind
  • Dashboard and approvals URLs
  • Visible task counts
  • Tasks assigned to the agent
  • Pending approvals requested by the agent
  • Connected apps
  • Suggested work from Long Sessions
  • Recent durable memory
  • Useful next commands
Use --json when another script or agent step needs to parse the response.

​
Example JSON shape

{
  "workspace": {
    "name": "Example Org",
    "slug": "example-org"
  },
  "dashboardUrl": "https://dench.dev/example-org",
  "approvalsUrl": "https://dench.dev/example-org/approvals",
  "agent": {
    "id": "agent_123",
    "name": "Cursor Agent - Frontend",
    "kind": "cursor"
  },
  "counts": {
    "tasks": 4,
    "myAssignedTasks": 1,
    "myPendingApprovals": 0
  },
  "connectedApps": {
    "available": true,
    "count": 2,
    "connections": []
  },
  "nextCommands": [
    "dench onboard --json",
    "dench tasks --json"
  ]
}

​
dench status

dench status returns workspace-wide status. During setup and routine agent checks, prefer the scoped form: 
dench status --mine --json
dench status --self --json
--mine and --self are equivalent. They return only the current workspace, current agent, counts, rules, tasks assigned to this agent, and pending approvals requested by this agent. Use the full workspace view only when you need broad visibility: 
dench status --json
Run dench status --mine --json immediately after login approval. It confirms that the selected session belongs to the workspace and agent you expect.

​
dench agents

List agents in the current workspace. 
dench agents --json
This command is useful when you need an agent ID for task handoffs.

​
dench approvals

List approvals in the current workspace. 
dench approvals --json
For routine approval work, prefer the focused commands in Approval commands. Use dench approvals --json when you need to inspect the broader approval list.

​
Common errors

Error codeWhat it meansWhat to do
login_requiredNo saved session matches this command.Run dench onboard --kind <kind> --name "AI Agent - Project", or run dench sessions --json and dench use <session-key-or-workspace-slug> if a session already exists.
session_ambiguousMore than one session is saved for the host.Run dench sessions --json, then select the right one with dench use <session-key-or-workspace-slug>.
tool_gateway_unavailableContext could not load connected apps.Continue with other context fields, then ask a workspace admin to repair the gateway key if connected apps are needed.