CLI Reference
The hoziron command-line interface is the primary operator tool for managing the Hoziron platform.
Installation
# Download the latest release
curl -sSL https://github.com/HozironOS/hoziron/releases/latest/download/hoziron-linux-amd64 -o hoziron
chmod +x hoziron
sudo mv hoziron /usr/local/bin/
Global Flags
These flags apply to all commands:
| Flag | Description |
|---|---|
--config <path> | Path to config file (default: ~/.hoziron/config.toml) |
--context <name> | Use a specific context for this command (overrides current_context) |
--help | Show help for any command |
--version | Show version information |
Command Overview
| Command | Description | Reference |
|---|---|---|
init | Initialize config directory | init.md |
start | Start the daemon | start-stop.md |
stop | Stop the daemon | start-stop.md |
agent | Manage agents (new, list, start, stop, chat) | agent.md |
workflow | Manage workflows (list, create, run) | workflow.md |
competency | Manage competencies (install, activate, configure) | competency.md |
package | Package authoring (init, build, sign, publish) | package.md |
catalog | Catalog discovery and installation | catalog.md |
config | Configuration management | config.md |
context | Multi-instance context switching | context.md |
channel | Channel integrations (Slack, Teams, etc.) | channel.md |
skill | Skill management | skill.md |
trigger | Event trigger management | trigger.md |
memory | Agent memory (KV store) | memory.md |
cron | Scheduled jobs | cron.md |
auth | Authentication and API keys | auth.md |
security | Security tools and audit | security.md |
models | Model and provider browsing | models.md |
integration | Integration server lifecycle | integration.md |
vault | Credential vault | vault.md |
webhooks | Webhook management | webhooks.md |
chat | Quick chat with an agent | utilities.md |
message | Send one-shot message | utilities.md |
status | Show kernel status | utilities.md |
health | Quick health check | utilities.md |
doctor | Run diagnostics | utilities.md |
logs | Tail daemon logs | utilities.md |
dashboard | Open web dashboard | utilities.md |
system | System info and version | utilities.md |
migrate | Migrate from another framework | utilities.md |
onboard | Interactive onboarding wizard | utilities.md |
reset | Reset local state | utilities.md |
uninstall | Remove Hoziron from system | utilities.md |
Quick Start Examples
# Initialize and start
hoziron init
hoziron start
# Create an agent and chat
hoziron agent new assistant
hoziron chat
# Check health
hoziron health
# View logs
hoziron logs --follow
Output Formats
Most commands support --json for machine-readable output:
# Human-readable (default)
hoziron agent list
# JSON (for scripting/piping)
hoziron agent list --json | jq '.[] | .name'
Environment Variables
| Variable | Purpose | Default |
|---|---|---|
HOZIRON_HOME | Config/data directory | ~/.hoziron |
HOZIRON_LISTEN | Daemon listen address | 127.0.0.1:4200 |
HOZIRON_LOG | Log level filter | info |
HOZIRON_LOG_FORMAT | Log format (text or json) | text |
Interactive Launcher
Running hoziron with no subcommand in an interactive terminal shows a branded launcher menu:
? What would you like to do?
→ Get Started (runs init)
→ Chat
→ Dashboard
→ Terminal UI
→ Show Help
→ Quit
In non-interactive mode (piped), it prints help text.