Create the agent

With the credential in place, one command creates an agent:

hiveloom agent create --name support-bot

That creates an agent with:

• name support-bot
• model claude-sonnet-4-20250514
• scope mode dual
• system prompt You are a helpful assistant.

To pin a specific model and prompt:

hiveloom agent create \
  --name support-bot \
  --model claude-sonnet-4-20250514 \
  --system-prompt "You are a friendly product-support agent for Hiveloom."

Use an OpenAI-family model if you stored the openai credential:

hiveloom agent create \
  --name support-bot \
  --model gpt-4o-mini \
  --system-prompt "You are a friendly product-support agent for Hiveloom."

Provider selection is implicit:

• claude-* models use the anthropic credential.
• all other model IDs use the openai credential.

Confirm

hiveloom agent list

Expect a table row for support-bot with its ID, model, and creation timestamp.

Inspect details:

hiveloom agent show <agent-id-or-name>

Interactive alternative

If you prefer a wizard:

hiveloom

Choose Setup from the TUI and follow the five guided steps: service → API key → agent → MCP → test chat.

Common errors

• credential 'anthropic' not found — you skipped Store an LLM credential, or the model family and stored credential do not match.
• Provider rejects the model — the model ID is syntactically accepted by the CLI, but your provider account does not have access to it.
• tenant 'default' not found — the service is not running yet. Start it with hiveloom serve or sudo systemctl start hiveloom.

Edit, version, delete

hiveloom agent edit <id>                  # change name, model, system prompt
hiveloom agent versions <id>              # list version history
hiveloom agent rollback <id> --to-version N
hiveloom agent delete <id>

Every change is versioned; rollback is safe.

Next: Chat with it from the CLI.