Command reference

This is a forward-looking specification. The agenetix CLI is not yet implemented.

Auth commands#

Command	Description
agenetix auth login	OAuth 2.1 PKCE login, stores token in OS keychain
agenetix auth logout	Clear stored tokens
agenetix auth status	Show current auth state
agenetix auth whoami	Show authenticated identity
agenetix auth token print	Print current access token
agenetix auth service-account create --org <id> --name <n> --scopes ...	Create service account
agenetix auth service-account list --org <id>	List service accounts
agenetix auth service-account rotate <id>	Rotate credentials
agenetix auth service-account revoke <id>	Revoke service account

MCP server commands#

Command	Description
agenetix mcp connect --url <url>	Connect existing MCP server
agenetix mcp generate --openapi <spec>	Generate from OpenAPI
agenetix mcp list [--kind generated|connected]	List servers
agenetix mcp show <id>	Show server details
agenetix mcp refresh-openapi <id> [--dry-run]	Non-destructive merge
agenetix mcp discover <id>	Rediscover connected server tools
agenetix mcp publish <id>	Publish / redeploy
agenetix mcp delete <id>	Delete server

Tool commands#

Command	Description
agenetix tool list --server <id>	List tools
agenetix tool show <server-id> <tool>	Show tool details
agenetix tool patch <server-id> <tool> [--enabled] [--instructions ...]	Edit tool rules
agenetix tool import-rules <server-id> --file rules.yaml	Bulk import from YAML
agenetix tool export-rules <server-id>	Export rules to YAML

Agent commands#

Command	Description
agenetix agent create --name ... --model ...	Create agent
agenetix agent attach <id> --server <id> [--enabled-tools ...]	Attach MCP server
agenetix agent detach <id> --server <id>	Detach MCP server
agenetix agent show <id>	Show agent details
agenetix agent chat <id>	Interactive REPL

Gateway commands#

Command	Description
agenetix gateway create --name ...	Create gateway profile
agenetix gateway list	List gateways
agenetix gateway attach <gw-id> --server <id>	Attach to server
agenetix gateway detach <gw-id> --server <id>	Detach from server

Utility commands#

Command	Description
agenetix logs tail --server <id> [--follow]	Stream request logs
agenetix audit tail [--actor ...] [--resource ...]	Stream audit events
agenetix config use-profile <name>	Switch active profile
agenetix config set <key> <value>	Set config value
agenetix doctor	Check connectivity and auth
agenetix version	Print version

Global flags#

All commands accept:

• --org <id> — override profile org
• --tenant <id> — override profile tenant
• --output table|json|yaml — output format
• --quiet — suppress non-essential output
• --dry-run — preview mode for write commands

Exit codes#

Code	Meaning
0	Success
1	User error
2	Auth error
3	Not found
4	Conflict (optimistic concurrency)
5	Server error