Skip to content

Quick Start // System Init

Zero to running agents in 5 minutes. The ostk kernel coordinates distributed AI agents through a cryptographic archive protocol.

ENVIRONMENT macOS / Linux
NETWORK_TRANS curl
VERSION_CTRL git 2.39+
AUTH_TIER GPG signing (optional)

GPG is optional for booting. Without any GPG key you boot at T3 (reads everything, writes denied by pin caps). With a GPG key that isn't cross-signed you're T2 (read + narrow write exceptions). With a T0-cross-signed key you're T1 (full write access). T0 is hardcoded trust anchors only — not reachable by ceremony.

01

INSTALL_BINARIES

SHELL
curl -fsSL https://ostk.ai/install.sh | sh

The script detects your platform, downloads the correct binary, verifies its GPG signature, and places it in your $PATH.

02

INITIALIZE_WORKSPACE

AUTOMATIC_DETECTION

Best for local development and single-node archives.

ostk init

GUIDED_CONFIG

7-step manual setup for distributed multi-agent clusters.

ostk init --guided

Both modes create .ostk/ with your HUMANFILE, Agentfile, pin.caps, and ostk.toml. Use --guided on your first project.

03

SYSTEM_BOOT

SHELL
ostk boot
EXPECTED_OUTPUT

boot: reaped 3 dead agent(s) from process table

HUMANFILE loaded (global only)

HUMANFILE: ✓ verified (T0), project unsigned

trust: T1 (cross-signed, write access)

driver rust: inactive (demand-spawn on first use)

.language: 58 verbs | fleet: 0 alive

needles: 0 open

boot confidence: 0.00 (restricted mode)

Loads state from .ostk/, detects your trust tier, and prints a status report. No configuration file needed. The OS reads the repo and orients.

04

LAUNCH_INTERFACE

SHELL
ostk tui

The ostk tui is your central command deck. Monitor the fleet, dispatch work via the tack bar, and approve permission gates in real-time.

From here, spawn your first agent: ostk kernel spawn worker --model sonnet --budget 2 "Fix the bug described in →001". See Commands for the full reference.

Boot shows T3 (anonymous) You have no GPG key. Generate one: gpg --full-generate-key. Then re-run ostk boot.
Boot shows T2 (read-only) Your GPG key exists but is not cross-signed by a T0 holder. Ask the project owner to sign your key.
"bail download failed" Network issue fetching governance package. ostk uses defaults. Re-run ostk init when connected.
"version mismatch" Your binary is older than ostk.toml requires. Update: cargo install ostk or re-run the install script.