CLI reference
doctor
Run diagnostic checks on your Treeship installation.
treeship doctor
Run 9 diagnostic checks to verify your Treeship setup is healthy.
treeship doctorOutput:
[pass] init -- Treeship is initialized
[pass] keypair -- Ed25519 keypair found
[pass] config -- Config file valid
[pass] hooks -- Shell hooks installed
[pass] daemon -- Daemon is running
[pass] hub -- Hub connection active
[pass] storage -- Local store readable and writable
[pass] permissions -- Key file permissions correct (0600)
[pass] session -- Active session found
9/9 checks passedWhat it checks
| Check | What it verifies |
|---|---|
init | ~/.treeship directory exists and contains required files |
keypair | Ed25519 signing key is present and loadable |
config | config.json parses without errors |
hooks | Shell hooks are installed in your profile |
daemon | Background daemon process is running |
hub | Can reach treeship.dev and authenticate |
storage | Local artifact store is readable and writable |
permissions | Private key file has mode 0600 (not world-readable) |
session | Reports whether an active session exists (informational, does not fail) |
If any check fails, treeship doctor prints the issue and a suggested fix. Exit code is 0 if all checks pass, 1 if any fail.