CLI: vyasa assistant
Usage: vyasa assistant [OPTIONS] COMMAND [ARGS]...
List, info, add, remove, set, and use assistants
┌─ Options ────────────────────────────────────────────────────────────────────┐
│ --help -h Show this message and exit. │
└──────────────────────────────────────────────────────────────────────────────┘
┌─ Commands ───────────────────────────────────────────────────────────────────┐
│ list List all configured assistants. │
│ info Show details for a configured assistant. │
│ use Launch a assistant for a session. │
│ add Add a custom assistant configuration. │
│ remove Remove a custom assistant. Cannot remove built-in. │
│ set Set the active assistant for session start. │
│ session Record the assistant's real session ID into the lock. │
└──────────────────────────────────────────────────────────────────────────────┘
vyasa assistant list
Usage: vyasa assistant list [OPTIONS]
List all configured assistants.
┌─ Options ────────────────────────────────────────────────────────────────────┐
│ --dir PATH Project directory │
│ --help -h Show this message and exit. │
└──────────────────────────────────────────────────────────────────────────────┘
vyasa assistant info
Usage: vyasa assistant info [OPTIONS] ASSISTANT_ID
Show details for a configured assistant.
┌─ Arguments ──────────────────────────────────────────────────────────────────┐
│ * assistant_id TEXT Assistant ID [required] │
└──────────────────────────────────────────────────────────────────────────────┘
┌─ Options ────────────────────────────────────────────────────────────────────┐
│ --dir PATH Project directory │
│ --help -h Show this message and exit. │
└──────────────────────────────────────────────────────────────────────────────┘
vyasa assistant use
Usage: vyasa assistant use [OPTIONS] [ASSISTANT_ID]
Launch a assistant for a session.
With --session: dispatch that session immediately.
Without --session:
- 0 active sessions: error.
- 1 active session: auto-pick it.
- >1 active session: prompt user to choose.
When ASSISTANT_ID is omitted, the project-level active assistant
(see `vyasa assistant set --name <id>`) is used.
The system prompt flag is only injected when a session is selected,
ensuring the agentic CLI always runs with the workspace context.
┌─ Arguments ──────────────────────────────────────────────────────────────────┐
│ assistant_id [ASSISTANT_ID] Assistant ID to use (default: │
│ project-level active, see `vyasa │
│ assistant set --name <id>`) │
└──────────────────────────────────────────────────────────────────────────────┘
┌─ Options ────────────────────────────────────────────────────────────────────┐
│ --session -s TEXT Session ID │
│ --name -n TEXT Name for the assistant session (enables resume │
│ after reject) │
│ --dir PATH Project directory │
│ --print -p Print the full command without launching │
│ --help -h Show this message and exit. │
└──────────────────────────────────────────────────────────────────────────────┘
vyasa assistant add
Usage: vyasa assistant add [OPTIONS]
Add a custom assistant configuration.
┌─ Options ────────────────────────────────────────────────────────────────────┐
│ * --name -n TEXT Assistant ID (e.g., ollama-claude) │
│ [required] │
│ * --command -c TEXT CLI command to launch [required] │
│ --args -a TEXT Additional CLI args (repeatable) │
│ --model -m TEXT Model name │
│ --provider TEXT API provider: anthropic or openai │
│ --base-url -u TEXT API base URL for local LLM │
│ --description -d TEXT Human-readable description │
│ --force -f Overwrite existing │
│ --dir PATH Project directory │
│ --help -h Show this message and exit. │
└──────────────────────────────────────────────────────────────────────────────┘
vyasa assistant remove
Usage: vyasa assistant remove [OPTIONS]
Remove a custom assistant. Cannot remove built-in.
┌─ Options ────────────────────────────────────────────────────────────────────┐
│ * --name -n TEXT Assistant ID to remove [required] │
│ --dir PATH Project directory │
│ --help -h Show this message and exit. │
└──────────────────────────────────────────────────────────────────────────────┘
vyasa assistant set
Usage: vyasa assistant set [OPTIONS]
Set the active assistant for session start.
┌─ Options ────────────────────────────────────────────────────────────────────┐
│ * --name -n TEXT Assistant ID to set as active [required] │
│ --dir PATH Project directory │
│ --help -h Show this message and exit. │
└──────────────────────────────────────────────────────────────────────────────┘
vyasa assistant session
Usage: vyasa assistant session [OPTIONS] SESSION_ID
Record the assistant's real session ID into the lock.
Called by the assistant itself (per the AGENT_CONTEXT.md Session Recording
instruction) so Vyasa can resume the actual assistant session later.
┌─ Arguments ──────────────────────────────────────────────────────────────────┐
│ * session_id TEXT Vyasa session ID [required] │
└──────────────────────────────────────────────────────────────────────────────┘
┌─ Options ────────────────────────────────────────────────────────────────────┐
│ * --id TEXT The assistant's real session ID [required] │
│ --pid INTEGER Assistant process PID (for the lock entry) │
│ [default: -1] │
│ --dir PATH Project directory │
│ --help -h Show this message and exit. │
└──────────────────────────────────────────────────────────────────────────────┘