Home

stencila agents create

Create a new agent

Creates a new agent directory with a template AGENT.md. By default creates in the workspace's .stencila/agents/ directory. Use --user to create in ~/.config/stencila/agents/ instead.

Usage

stencila agents create [OPTIONS] <NAME> <DESCRIPTION>

Examples

# Create a new agent in the workspace
stencila agents create my-agent "A helpful assistant"

# Create a new agent in user config
stencila agents create my-agent "A helpful assistant" --user

Arguments

NameDescription
<NAME>The name for the new agent.
<DESCRIPTION>A brief description of the new agent.

Options

NameDescription
--userCreate in user config directory instead of workspace. Possible values: true, false.
© 2026 Stencila