understudy
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| UNDERSTUDY_MODEL | No | Model passed to OpenCode (`provider/model`). | ollama/qwen3:8b |
| UNDERSTUDY_BUILDER | No | `opencode` or `command`. | opencode |
| UNDERSTUDY_MAX_ROUNDS | No | Build → test attempts per call. | 3 |
| UNDERSTUDY_TEST_TIMEOUT | No | Seconds per test run. | 600 |
| UNDERSTUDY_WORKTREE_DIR | No | Where worktrees are created. Must be outside `.git`. | ~/.cache/understudy/worktrees |
| UNDERSTUDY_MAX_DIFF_CHARS | No | Longer diffs are truncated in results. | 20000 |
| UNDERSTUDY_BUILDER_COMMAND | No | Command for the `command` builder. Contains `{prompt_file}` and `{workdir}` placeholders. | |
| UNDERSTUDY_BUILDER_TIMEOUT | No | Seconds per model run. | 900 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| delegateA | Hand a coding task to the local model. The model edits an isolated git worktree; Returns the diff and test output for you to review, plus an id for
accept/revise/discard. |
| reviseA | Send review feedback on a delegation; the local model tries again and the tests are re-run. Returns the updated diff and test output. |
| acceptA | Merge a delegation into the current branch as a single commit (the task
text is used as the message unless |
| discardA | Throw away a delegation's worktree and branch without merging. |
| statusA | List delegations in this repository that have not been accepted or discarded. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 5 tools
Each tool maps to a distinct phase of the delegation lifecycle: delegate starts, revise updates, accept finalizes, discard cancels, and status inspects. There is no overlap or ambiguity between responsibilities.
All tool names are single-word imperative verbs (delegate, revise, accept, discard, status), forming a predictable pattern. No mixed conventions or stylistic deviations.
Five tools is the ideal scope for a delegation workflow: create, iterate, merge, cancel, and list. Each tool earns its place without redundancy or bloat.
The lifecycle is fully covered: delegate creates a task, revise handles iterative feedback, accept and discard resolve it, and status provides visibility. No essential operation is missing.