@arborship/cli

The levi command-line interface. It is the primary surface for managing Levi VMs and nodes and for working with the product-facing Workshop model (tasks, runs, results, approvals, permissions) — an oclif application that translates flags and subcommands into calls on the Levi SDK and application capability layer.

Layer

Surface adapter (docs/architecture/PLATFORM_BOUNDARIES.md, Layer 1). It owns flag parsing, output rendering, and command discovery, and delegates actual work to @arborship/sdk, @arborship/application, and @arborship/control-plane-sdk rather than talking to drivers or the database directly.

Install

npm install -g @arborship/cli

This installs the levi binary.

Usage

# Print the installed version without loading any subsystem
levi --version

# List available commands and topics
levi --help

# VM lifecycle
levi vm list
levi vm create my-vm
levi vm start my-vm

# Workshop: tasks, runs, results
levi work task list
levi work run attach <run-id>
levi results show <result-id>

Command output follows the CLI's normal conventions: interactive sessions get human-readable tables, and agent/CI contexts (or --output json, where a command supports it) get machine-readable JSON.

Part of Levi

This package is part of Levi, an isolated personal agent control plane. See the project's docs/ directory, particularly docs/architecture/, for the surrounding architecture.

License

Apache-2.0. See the LICENSE file in this package; the full license set is described in the repository's docs/architecture/LICENSING_AND_TOPOLOGY.md.