Skip to main content

Server

agentsmithy

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

agentsmithy <command> [flags]
FlagTypeDefaultDescription
-h, --helpboolShow 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]