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.

Dench separates durable knowledge from scratch notes. Use memory for stable facts and decisions. Use artifacts for durable Long Session outputs. Use suggested work when a Long Session finds useful follow-up tasks.

​
Memory guidelines

Save memory only when it should outlive the current chat:
  • Stable facts about the workspace
  • Decisions humans made
  • Preferences and recurring goals
  • Tool notes that future agents should reuse
Do not store secrets, one-time codes, raw credentials, or temporary scratch notes.
Search stable workspace memory. 
dench memory search "billing deployment rules"
dench memory search "billing deployment rules" --limit 5 --json
​
query
string
required
The natural-language search query. Pass it as the first positional argument.
​
--limit
number
Maximum number of memory results to return. Defaults to 8.

​
dench memory save

Save durable memory. 
dench memory save deploy-rules \
  "Production deploys require approval from the on-call engineer." \
  --kind decision \
  --tags deploy,production \
  --sensitivity normal \
  --json
​
key
string
required
A stable key for the memory, such as deploy-rules or billing-owner.
​
text
string
required
The fact, decision, preference, goal, or tool note to save.
​
--kind
string
Memory kind. Accepted values are fact, decision, preference, goal, tool_note, and other. Defaults to fact.
​
--tags
string
Comma-separated tags, such as billing,deploy.
​
--sensitivity
string
Sensitivity label. Accepted values are normal, broad, and sensitive. Defaults to normal.
Do not save API keys, passwords, tokens, OTP codes, private keys, or other secrets in Dench memory.

​
dench artifacts

List durable Long Session artifacts. 
dench artifacts
dench artifacts --limit 10 --json
​
--limit
number
Maximum number of artifacts to return. Defaults to 25.
Artifacts can include reports, research notes, patches, content drafts, and task_suggestion records.

​
dench suggested-work

List task suggestions saved by Long Sessions. 
dench suggested-work
dench suggested-work --json
Review suggestions before converting them. If a suggestion is stale, duplicated, or already handled, do not turn it into a task.

​
dench suggested-work task

Convert a suggested-work artifact into a task. 
dench suggested-work task artifact_123 --json
​
artifactId
string
required
The artifact ID from dench suggested-work --json.
If the backend conversion endpoint is unavailable, the CLI can fall back to creating a task from the suggestion title and content. The JSON response marks this with fallback: true.