Agent Lifecycle

Validate

rebyte agent validate -f agent.toml

Validation is local and needs no API key. It parses TOML, validates every field, and resolves prompt_file.

Create

export REBYTE_API_KEY="rbk_..."
rebyte agent create -f agent.toml

The Agent belongs to the API key's organization and does not appear in the Workspace Agent UI. Run it through /v1/responses.

Apply

rebyte agent apply "$REBYTE_AGENT_ID" -f agent.toml

apply sends the complete resolved manifest. Omitting skills or capabilities applies their documented initial values; it is not a partial patch.

Export

rebyte agent export "$REBYTE_AGENT_ID" -o agent.toml

Export emits canonical TOML with an inline prompt. It cannot preserve comments, formatting, or the original prompt_file path. It refuses to replace an existing file unless --force is supplied. Omit -o or pass -o - for stdout.

Command reference

rebyte agent validate [-f agent.toml]
rebyte agent create [-f agent.toml]
rebyte agent apply <agent-id> [-f agent.toml]
rebyte agent export <agent-id> [-o agent.toml] [--force]