Skip to main content

Server

agentsmithy​

Project-agnostic AI Agent server. Reads .agentsmithy.yaml and serves an AI Agent.

agentsmithy <command> [flags]
FlagTypeDefaultDescription
-h, --helpbool—Show context-sensitive help.
-l, --log-levelenum(debug,info,warn,error)infoLog level (one of: debug,info,warn,error).

serve​

Start the agent server.

agentsmithy serve [flags]
FlagTypeDefaultDescription
-c, --configstring.agentsmithy.yamlPath to config.
--transportenum(a2a,stdio,mcp-stdio,mcp-http,none)a2aTransport to use (one of: a2a,stdio,mcp-stdio,mcp-http,none).
--addrstring:8080Listen address (HTTP-like transports).
--watchboolfalseWatch config file and hot-reload on change.
-o, --oncestring—(stdio only) Send a single prompt, print the reply, then exit.
-v, --verbosebool—(stdio only) Print tool calls and intermediate steps.

validate​

Validate config file.

agentsmithy validate [flags]
FlagTypeDefaultDescription
-c, --configstring.agentsmithy.yamlPath to config.

setup​

Start the config-authoring MCP assistant.

agentsmithy setup [flags]