CLI

Package: cmd/pub/arizuko/. Host-side management commands.

arizuko create

arizuko create <name>

Seeds a new instance data directory at /srv/data/arizuko_<name>/ (or ${PREFIX}/data/arizuko_<name>/):

• Creates directory structure: store/, groups/, data/, services/
• Writes a template .env file with all config keys and empty values
• Creates a default group directory (groups/main/) with a starter CLAUDE.md
• Inserts the default group into the database

Does not start any services. Edit .env before running.

arizuko generate

arizuko generate <instance>

Reads /srv/data/arizuko_<instance>/.env and any services/*.toml files. Writes docker-compose.yml to the data directory. Does not call Docker.

See Compose for file format details.

arizuko run

arizuko run <instance>

Calls generate then runs docker compose up -d in the data directory. This is what the systemd unit calls.

arizuko group

arizuko group <instance> list
arizuko group <instance> add <jid> [--trigger <word>] [--folder <name>]
arizuko group <instance> rm <jid>

Manages registered groups in the running instance's database.

Subcommand	Action
list	Print all registered groups: JID, folder, trigger word, parent
add <jid>	Register a new group for the given JID. Creates the group directory if it does not exist. --trigger sets the activation word; --folder overrides the default folder name derived from the JID.
rm <jid>	Remove the group registration. Does not delete the group directory or its contents.

arizuko status

arizuko status <instance>

Prints current state of the instance:

• Docker Compose service status (calls docker compose ps)
• Registered channels (from database)
• Registered groups (from database)
• Active containers (from docker ps --filter name=arizuko-)

Future: arizuko chat

A CLI chat mode is planned (specs/cli-chat.md). It will connect directly to a running instance and allow sending messages and receiving responses in the terminal, without a channel adapter.