CLI reference
init
Set up a new Treeship trust domain.
Usage
treeship init [OPTIONS]What it does
Creates a new Treeship with:
- An optional name
- A new Ed25519 keypair, encrypted at rest
No account, no email, no network connection required. Everything is generated locally.
Example
treeship init✓ Treeship initialized
Ship ID: ship_0ab4e2205a1c05c5
Key ID: key_f9a10fde95b3bccc
Next:
→ treeship add instrument your AI agents
→ treeship session start begin recording a sessionThe key is encrypted at rest under .treeship/keys/. --name is recorded in
the config but is not echoed back in this output.
Options
| Option | Description |
|---|---|
--name <NAME> | Treeship name (optional) |
--template <TEMPLATE> | Apply a trust template by name or file path |
--force | Overwrite an existing config |
--global | Initialize the global store instead of a project-local one |
--config <PATH> | Config file path |
Non-interactive
treeship init --name ci-shipUseful for CI environments where interactive prompts are not available.
What gets created
~/.treeship/
└── config.json # Treeship configuration
└── keystore/ # Encrypted Ed25519 keypair
└── artifacts/ # Local artifact store