agent

App color scheme.

The default agent name used when no -a flag is provided.

Get the default coding agent instructions.

These are the immutable base instructions that cannot be modified by the agent. Long-term memory (AGENTS.md) is handled separately by the middleware.

Get the glyph set for the current charset mode.

Get the default working directory for a given sandbox provider.

List subagents from user and/or project directories.

Scans for subagent definitions in the provided directories. Project subagents override user subagents with the same name.

List all available agents.

Reset an agent to default or copy from another agent.

Get the base system prompt for the agent.

Loads the immutable system prompt from system_prompt.md and interpolates dynamic sections (model identity, working directory, skills path).

Create a CLI-configured agent with flexible options.

This is the main entry point for creating a deepagents CLI agent, usable both internally and from external code (e.g., benchmarking frameworks).

Inject local context (git state, project structure, etc.) into the system prompt.

Runs a bash detection script via backend.execute() on first interaction and again after each summarization event, stores the result in state, and appends it to the system prompt on every model call.

Because the script runs inside the backend, it works for both local shells and remote sandboxes.