Treeship
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 session

The key is encrypted at rest under .treeship/keys/. --name is recorded in the config but is not echoed back in this output.

Options

OptionDescription
--name <NAME>Treeship name (optional)
--template <TEMPLATE>Apply a trust template by name or file path
--forceOverwrite an existing config
--globalInitialize the global store instead of a project-local one
--config <PATH>Config file path

Non-interactive

treeship init --name ci-ship

Useful 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