hoziron-cli init

Create the CLI's local config directory. This is deliberately minimal — it does not set up a provider, an API key, or a data directory. Provider configuration lives on the server side; connecting the CLI to a server is a separate step (hoziron-cli onboard).

Synopsis

hoziron-cli init [--quick]

Flags

FlagDescription
--quickAccepted by the parser but currently has no effect — init is already fully non-interactive and behaves identically with or without this flag.

What It Actually Does

  1. Creates $HOZIRON_HOME (default ~/.hoziron/) if it doesn't exist.
  2. If config.toml doesn't already exist, writes a two-line placeholder: 
    # Hoziron CLI Configuration
# Run `hoziron-cli onboard` to connect to an API server.
  3. Prints what it did and a pointer to hoziron-cli onboard.

That's it. init does not:

  • Prompt for a provider or API key (there is no interactive flow here at all)
  • Write .env
  • Create a data/ subdirectory
  • Populate [default_model] or [providers.*] sections in config.toml

If you want the guided, interactive flow, run hoziron-cli onboard instead — that's the command that prompts for a server URL, saves it as a context, and optionally configures a CLI-to-daemon API key. See utilities.md#onboard.

Examples

First run

$ hoziron-cli init
✓ Created /root/.hoziron
✓ Config at /root/.hoziron/config.toml

Next: run `hoziron-cli onboard` to connect to your API server.

Already initialized (idempotent)

$ hoziron-cli init
Configuration already exists at /root/.hoziron/config.toml

With custom config path

$ hoziron-cli --config /opt/hoziron/config.toml init
✓ Created /opt/hoziron
✓ Config at /opt/hoziron/config.toml

With HOZIRON_HOME

$ export HOZIRON_HOME=/opt/hoziron
$ hoziron-cli init
✓ Created /opt/hoziron
✓ Config at /opt/hoziron/config.toml

Notes

  • Running init when $HOZIRON_HOME already exists is safe — it never overwrites an existing config.toml.
  • Provider/model configuration ([default_model], [providers.*]) is server-side config, edited on the machine running hoziron-server — see config.md and ../../getting-started/README.md for the server side.
  • Use hoziron-cli reset --confirm to clear CLI-side config (contexts, .env) — see utilities.md#reset.

See Also