CLI & ABI Reference
ostk is structured as a microkernel. It separates the human user experience from the agent program interface.
The CLI you run in your terminal is the Operator Overlay, optimized for human ergonomics, scripting, and visualization. Underneath, all operations go through the System ABI, a stable, schema-validated JSON-RPC interface that agents call directly via the MCP bridge or the UNIX domain socket.
Operator Overlay vs. System ABI
This decoupled architecture ensures that developer tools and terminal commands can evolve rapidly without breaking existing agent implementations or custom toolchains.
Clap-style terminal commands and interactive UI utilities. Safe to alias, format, and rename.
ostk boot — Load the kernel and verify trust anchorsostk daemon — Spawn background socket serverostk tui — Live dashboard and manual work entryostk ps — POSIX-compliant fleet process treeostk run <file> — Load and execute AgentfileStrictly typed, version-hashed JSON-RPC schema. Frozen between major releases.
read — Offset-safe file reads with token estimationfs_ops — Generation-tracked atomic write/editbash — Landlock-sandboxed shell command executorspawn — Spawn long-lived driver with wait conditionsinteract — Read/write streams of running processesFS_OPS: Atomic Generation-Tracked Edits
The most critical verb in the System ABI is fs_ops. Unlike naive file writes, fs_ops integrates with gen_table.jsonl to implement Optimistic Concurrency Control (OCC). It supports two modes:
1. Quick Mode (Single File CAS & Writes)
Optimized for single-target changes. Quick mode is triggered by providing a top-level path.
- Compare-and-Swap (CAS) Edit: Provide
path,old_str, andnew_str. The kernel verifies thatold_strmatches the file content exactly and is unique before replacing it withnew_str. If multiple occurrences match andreplace_allis nottrue, the call errors. - Full File Write: Provide
pathandnew_str(omitold_str). The kernel overwrites or creates the file. - Directory/File Creation: Use
op: "mkdir"orop: "write"as a discriminator for non-content adjustments.
2. Batch Mode (Multi-File Atomic Transactions)
For multi-file operations (like renaming a module and updating all its import references), pass an array of operations in the ops parameter. All operations run sequentially within a single audit transaction.
{
"ops": [
{ "method": "shell.run", "cmd": "mv src/old.rs src/new.rs" },
{ "method": "file.str_replace", "path": "src/lib.rs", "old": "pub mod old;", "new": "pub mod new;" },
{ "method": "file.str_replace", "path": "src/main.rs", "old": "use crate::old;", "new": "use crate::new;" }
]
}
Inspecting the Kernel Envelope
Every action requested of the microkernel is wrapped in a JSON-RPC 2.0 request envelope. The envelope enforces tracking, permission caps, and concurrency guards. You can interface with it in three ways:
1. CLI Dispatch Wrapper
Use the ostk dispatch operator command to load a verb and run it directly with arguments as JSON.
$ ostk dispatch fs_ops --args '{"path": "test.txt", "new_str": "hello world"}' dispatch:fs_ops ok → { "status": "success", "generation": 1 }
2. UNIX Domain Socket IPC
When the kernel is booted, it listens on .ostk/ostk.sock. You can write raw JSON-RPC payloads directly to this socket using netcat.
$ echo '{"jsonrpc":"2.0","method":"read","params":{"path":"README.md","limit":100},"id":42}' | nc -U .ostk/ostk.sock {"jsonrpc":"2.0","result":{"text":"# ostk-site..."},"id":42}
3. The Live Kernel Log
Every processed envelope registers in the active daemon journal log. You can follow this stream to see live calls, latency, and returned results in real time.
$ tail -f .ostk/journal.jsonl {"seq":84,"timestamp":"2026-05-22T21:34:37Z","verb":"read","args":{"path":"v2/package.json"},"signer":"T0"}
Interactive Command & ABI Explorer
Use the explorer below to search all 66 core CLI commands and ABI verbs. Find option flags, discover sandbox boundaries, and generate valid JSON-RPC request structures.
Emit a presence handshake glyph
// Options & Arguments
// Execution Context
This verb executes within Landlock sandbox configurations and registers in the audit ledger.
// JSON-RPC Request
{
"jsonrpc": "2.0",
"method": "arrive",
"params": {
"json": true
},
"id": 42
} View Raw Help Details
Emit a presence handshake glyph
Usage: ostk arrive [OPTIONS]
Options:
--json Emit JSON
-v, --verbose Print info-level kernel logs to stderr
-h, --help Print help
Run a shell command through the kernel
// Options & Arguments
// Execution Context
This verb executes within Landlock sandbox configurations and registers in the audit ledger.
// JSON-RPC Request
{
"jsonrpc": "2.0",
"method": "bash",
"params": {
"cmd": "cargo test",
"cwd": "/Users/scottmeyer/projects/ostk-site",
"timeout": 30
},
"id": 42
} View Raw Help Details
Run a shell command through the kernel
Usage: ostk bash [OPTIONS] <CMD>
Arguments:
<CMD> Shell command line
Options:
--cwd <CWD> Working directory override
--timeout <TIMEOUT> Wall-clock deadline in seconds
--raw Skip squasher / elision compression
-v, --verbose Print info-level kernel logs to stderr
--json Emit JSON
-h, --help Print help
Demote a context page from hot to warm tier
// Options & Arguments
// Execution Context
This verb executes within Landlock sandbox configurations and registers in the audit ledger.
// JSON-RPC Request
{
"jsonrpc": "2.0",
"method": "context_evict",
"params": {
"name": "spec-doc-v1"
},
"id": 42
} View Raw Help Details
Demote a context page from hot to warm tier
Usage: ostk context-evict [OPTIONS] <NAME>
Arguments:
<NAME> Page identifier
Options:
--json Emit JSON
-v, --verbose Print info-level kernel logs to stderr
-h, --help Print help
Load a context page into the hot tier
// Options & Arguments
// Execution Context
This verb executes within Landlock sandbox configurations and registers in the audit ledger.
// JSON-RPC Request
{
"jsonrpc": "2.0",
"method": "context_load",
"params": {
"name": "spec-doc-v1"
},
"id": 42
} View Raw Help Details
Load a context page into the hot tier
Usage: ostk context-load [OPTIONS] <NAME>
Arguments:
<NAME> Page identifier
Options:
--json Emit JSON
-v, --verbose Print info-level kernel logs to stderr
-h, --help Print help
List context pages, optionally filtered by tier
// Options & Arguments
// Execution Context
This verb executes within Landlock sandbox configurations and registers in the audit ledger.
// JSON-RPC Request
{
"jsonrpc": "2.0",
"method": "context_pages",
"params": {
"state": "hot"
},
"id": 42
} View Raw Help Details
List context pages, optionally filtered by tier
Usage: ostk context-pages [OPTIONS]
Options:
--state <STATE> Filter by tier: hot, warm, cold
--json Emit JSON
-v, --verbose Print info-level kernel logs to stderr
-h, --help Print help
Toggle eviction protection on a context page
// Options & Arguments
// Execution Context
This verb executes within Landlock sandbox configurations and registers in the audit ledger.
// JSON-RPC Request
{
"jsonrpc": "2.0",
"method": "context_pin",
"params": {
"name": "spec-doc-v1",
"unpin": false
},
"id": 42
} View Raw Help Details
Toggle eviction protection on a context page
Usage: ostk context-pin [OPTIONS] <NAME>
Arguments:
<NAME> Page identifier
Options:
--unpin Inverse: clear the pin instead of setting it
--json Emit JSON
-v, --verbose Print info-level kernel logs to stderr
-h, --help Print help
Mark a context page warm and free its hot slot
// Options & Arguments
// Execution Context
This verb executes within Landlock sandbox configurations and registers in the audit ledger.
// JSON-RPC Request
{
"jsonrpc": "2.0",
"method": "context_release",
"params": {
"name": "spec-doc-v1"
},
"id": 42
} View Raw Help Details
Mark a context page warm and free its hot slot
Usage: ostk context-release [OPTIONS] <NAME>
Arguments:
<NAME> Page identifier
Options:
--json Emit JSON
-v, --verbose Print info-level kernel logs to stderr
-h, --help Print help
Promote a warm or cold context page back to hot
// Options & Arguments
// Execution Context
This verb executes within Landlock sandbox configurations and registers in the audit ledger.
// JSON-RPC Request
{
"jsonrpc": "2.0",
"method": "context_restore",
"params": {
"name": "spec-doc-v1"
},
"id": 42
} View Raw Help Details
Promote a warm or cold context page back to hot
Usage: ostk context-restore [OPTIONS] <NAME>
Arguments:
<NAME> Page identifier
Options:
--json Emit JSON
-v, --verbose Print info-level kernel logs to stderr
-h, --help Print help
Store new content as a cold-tier context page
// Options & Arguments
// Execution Context
This verb executes within Landlock sandbox configurations and registers in the audit ledger.
// JSON-RPC Request
{
"jsonrpc": "2.0",
"method": "context_store",
"params": {
"name": "spec-doc-v1",
"content": "This is the content of the page."
},
"id": 42
} View Raw Help Details
Store new content as a cold-tier context page
Usage: ostk context-store [OPTIONS] <NAME> <CONTENT>
Arguments:
<NAME> Page identifier
<CONTENT> Page body content
Options:
--owner <OWNER> Owner attribution string
--json Emit JSON
-v, --verbose Print info-level kernel logs to stderr
-h, --help Print help
Invoke a kernel verb by name with a JSON args payload
// Options & Arguments
// Execution Context
This verb executes within Landlock sandbox configurations and registers in the audit ledger.
// JSON-RPC Request
{
"jsonrpc": "2.0",
"method": "dispatch",
"params": {
"verb": "fs_ops",
"args": {
"path": "test.txt",
"new_str": "hello"
}
},
"id": 42
} View Raw Help Details
Invoke a kernel verb by name with a JSON args payload
Usage: ostk dispatch [OPTIONS] [VERB]
Arguments:
[VERB] Underlying verb name (omit when --ops is used for batch mode) [default: ""]
Options:
--args <ARGS> JSON object of underlying-verb arguments
--ops <OPS> JSON list of {verb, args} batch entries
--atomic Request all-or-nothing semantics for the batch
-v, --verbose Print info-level kernel logs to stderr
--json Emit JSON
-h, --help Print help
Mutate a file — CAS edit, write, mkdir, mv, cp, rm, chmod
// Options & Arguments
// Execution Context
This verb executes within Landlock sandbox configurations and registers in the audit ledger.
// JSON-RPC Request
{
"jsonrpc": "2.0",
"method": "fs_ops",
"params": {
"path": "src/lib.rs",
"old_str": "pub mod old;",
"new_str": "pub mod new;"
},
"id": 42
} View Raw Help Details
Mutate a file — CAS edit, write, mkdir, mv, cp, rm, chmod
Usage: ostk fs-ops [OPTIONS] [PATH]
Arguments:
[PATH] Filesystem path target [default: ""]
Options:
--op <OP> Non-content op discriminator: mkdir, mv, cp, rm, chmod, write
--old-str <OLD_STR> CAS-edit "before" string
--new-str <NEW_STR> CAS-edit "after" / new file content
-v, --verbose Print info-level kernel logs to stderr
--ops <OPS> JSON list of batched operations
--json Emit JSON
-h, --help Print help
Switch model and inject a transition message
// Options & Arguments
// Execution Context
This verb executes within Landlock sandbox configurations and registers in the audit ledger.
// JSON-RPC Request
{
"jsonrpc": "2.0",
"method": "handoff",
"params": {
"model": "claude-3-opus",
"message": "Please review this build failure and correct imports."
},
"id": 42
} View Raw Help Details
Switch model and inject a transition message
Usage: ostk handoff [OPTIONS] <TARGET>
Arguments:
<TARGET> Identifier of the destination model / agent
Options:
--transition <TRANSITION> Free-form transition message body
--json Emit JSON
-v, --verbose Print info-level kernel logs to stderr
-h, --help Print help
Render the man page for a System ABI verb
// Options & Arguments
// Execution Context
This verb executes within Landlock sandbox configurations and registers in the audit ledger.
// JSON-RPC Request
{
"jsonrpc": "2.0",
"method": "help",
"params": {},
"id": 42
} View Raw Help Details
Render the man page for a System ABI verb
Usage: ostk help [OPTIONS] [VERB]
Arguments:
[VERB] Verb name; omit for usage hint
Options:
-v, --verbose Print info-level kernel logs to stderr
-h, --help Print help
Read tail, send input, signal, kill, or status a process
// Options & Arguments
// Execution Context
This verb executes within Landlock sandbox configurations and registers in the audit ledger.
// JSON-RPC Request
{
"jsonrpc": "2.0",
"method": "interact",
"params": {
"alias": "dev-server",
"action": "status"
},
"id": 42
} View Raw Help Details
Read tail, send input, signal, kill, or status a process
Usage: ostk interact [OPTIONS] --action <ACTION> <ALIAS>
Arguments:
<ALIAS> Process alias previously registered by spawn
Options:
--action <ACTION> Sub-mode discriminator: read_tail, send_input, send_signal, kill, status
--input <INPUT> Input to send (for send_input / send_signal)
--lines <LINES> Number of lines to read (for read_tail)
-v, --verbose Print info-level kernel logs to stderr
--timeout <TIMEOUT> Wall-clock deadline in seconds
--json Emit JSON
-h, --help Print help
Create, release, watch, or query a coordination lock
// Options & Arguments
// Execution Context
This verb executes within Landlock sandbox configurations and registers in the audit ledger.
// JSON-RPC Request
{
"jsonrpc": "2.0",
"method": "lock",
"params": {
"action": "create",
"name": "compile-lock"
},
"id": 42
} View Raw Help Details
Create, release, watch, or query a coordination lock
Usage: ostk lock [OPTIONS] --action <ACTION> --name <NAME>
Options:
--action <ACTION> Sub-mode discriminator: create, release, watch, status
--name <NAME> Lock name
--timeout <TIMEOUT> Watch timeout in seconds
-v, --verbose Print info-level kernel logs to stderr
--json Emit JSON
-h, --help Print help
Append an annotation to the audit stream
// Options & Arguments
// Execution Context
This verb executes within Landlock sandbox configurations and registers in the audit ledger.
// JSON-RPC Request
{
"jsonrpc": "2.0",
"method": "note",
"params": {
"text": "Completed database migrations"
},
"id": 42
} View Raw Help Details
Append an annotation to the audit stream
Usage: ostk note [OPTIONS] <TEXT>
Arguments:
<TEXT> Annotation text body
Options:
--json Emit JSON
-v, --verbose Print info-level kernel logs to stderr
-h, --help Print help
Read a file with gen tracking and elision-aware output
// Options & Arguments
// Execution Context
This verb executes within Landlock sandbox configurations and registers in the audit ledger.
// JSON-RPC Request
{
"jsonrpc": "2.0",
"method": "read",
"params": {
"path": "src/main.rs",
"limit": 500
},
"id": 42
} View Raw Help Details
Read a file with gen tracking and elision-aware output
Usage: ostk read [OPTIONS] <PATH>
Arguments:
<PATH> File path to read
Options:
--offset <OFFSET> Start line (1-indexed)
--limit <LIMIT> Maximum lines to return
--enrich Overlay driver-supplied diagnostics on the result
-v, --verbose Print info-level kernel logs to stderr
--json Emit JSON
-h, --help Print help
Search code, hay, decisions, and transcripts
// Options & Arguments
// Execution Context
This verb executes within Landlock sandbox configurations and registers in the audit ledger.
// JSON-RPC Request
{
"jsonrpc": "2.0",
"method": "search",
"params": {
"query": "fn main",
"scope": "code",
"mode": "literal"
},
"id": 42
} View Raw Help Details
Search code, hay, decisions, and transcripts
Usage: ostk search [OPTIONS] <QUERY>
Arguments:
<QUERY> Search query (regex or literal string)
Options:
--path <PATH> Limit search to this path
--scope <SCOPE> Search boundary: code, files, work, history, decisions, transcripts, all, vfs (default: code) [default: code]
--mode <MODE> Match mode: literal, regex, glob, semantic, symbol, id (default: regex/literal inference)
-v, --verbose Print info-level kernel logs to stderr
--expand <EXPAND> Result expansion: callers, history, semantic, attribution
--limit <LIMIT> Max results (default 20) [default: 20]
--semantic Use semantic search via LLM (alias for `--mode semantic` `--scope all`). Mutually exclusive with `--mode` to avoid ambiguous combinations
-h, --help Print help
List, create, or close a kernel session
// Options & Arguments
// Execution Context
This verb executes within Landlock sandbox configurations and registers in the audit ledger.
// JSON-RPC Request
{
"jsonrpc": "2.0",
"method": "session",
"params": {
"action": "list"
},
"id": 42
} View Raw Help Details
List, create, or close a kernel session
Usage: ostk session [OPTIONS] --action <ACTION>
Options:
--action <ACTION> Sub-mode discriminator: list, create, close
--name <NAME> Session name (for create / close)
--json Emit JSON
-v, --verbose Print info-level kernel logs to stderr
-h, --help Print help
Replay the session event log
// Options & Arguments
// Execution Context
This verb executes within Landlock sandbox configurations and registers in the audit ledger.
// JSON-RPC Request
{
"jsonrpc": "2.0",
"method": "session_history",
"params": {
"limit": 100
},
"id": 42
} View Raw Help Details
Replay the session event log
Usage: ostk session-history [OPTIONS]
Options:
--limit <LIMIT> Maximum events to return
--json Emit JSON
-v, --verbose Print info-level kernel logs to stderr
-h, --help Print help
Start a background process under an alias
// Options & Arguments
// Execution Context
This verb executes within Landlock sandbox configurations and registers in the audit ledger.
// JSON-RPC Request
{
"jsonrpc": "2.0",
"method": "spawn",
"params": {
"alias": "web-server",
"cmd": "npm run dev",
"wait_for": "ready"
},
"id": 42
} View Raw Help Details
Start a background process under an alias
Usage: ostk spawn [OPTIONS] <ALIAS> <CMD>
Arguments:
<ALIAS> Process alias
<CMD> Shell command line
Options:
--wait-for <WAIT_FOR> Regex matched against child output before declaring readiness
--timeout <TIMEOUT> Wall-clock deadline in seconds
--json Emit JSON
-v, --verbose Print info-level kernel logs to stderr
-h, --help Print help
Resolve a tack expression — preview, dispatch, or LLM call
// Options & Arguments
// Execution Context
This verb executes within Landlock sandbox configurations and registers in the audit ledger.
// JSON-RPC Request
{
"jsonrpc": "2.0",
"method": "tack",
"params": {
"expr": "model:sonnet -> file:src/main.rs"
},
"id": 42
} View Raw Help Details
Resolve a tack expression — preview, dispatch, or LLM call
Usage: ostk tack [OPTIONS] <INPUT>
Arguments:
<INPUT> Tack expression (e.g. ':compile', '.? status', '→437')
Options:
--json Output as JSON
--run Resolve and dispatch the verb (was `ostk do`)
--llm Single-turn LLM call with the expression as user message (was `ostk ask`)
-v, --verbose Print info-level kernel logs to stderr
--max-tokens <MAX_TOKENS> With `--llm`, max response tokens [default: 1024]
-h, --help Print help
Render help text for a single kernel verb
// Options & Arguments
// Execution Context
This verb executes within Landlock sandbox configurations and registers in the audit ledger.
// JSON-RPC Request
{
"jsonrpc": "2.0",
"method": "verb_help",
"params": {},
"id": 42
} View Raw Help Details
Render help text for a single kernel verb
Usage: ostk verb-help [OPTIONS] <NAME>
Arguments:
<NAME> Verb name to render help for
Options:
--json Emit JSON
-v, --verbose Print info-level kernel logs to stderr
-h, --help Print help
Demand-load the schema for a deferred verb
// Options & Arguments
// Execution Context
This verb executes within Landlock sandbox configurations and registers in the audit ledger.
// JSON-RPC Request
{
"jsonrpc": "2.0",
"method": "verb_load",
"params": {},
"id": 42
} View Raw Help Details
Demand-load the schema for a deferred verb
Usage: ostk verb-load [OPTIONS] <NAME>
Arguments:
<NAME> Verb name to load schema for
Options:
--json Emit JSON
-v, --verbose Print info-level kernel logs to stderr
-h, --help Print help
Extract all links from a web page
// Options & Arguments
// Execution Context
This verb executes within Landlock sandbox configurations and registers in the audit ledger.
// JSON-RPC Request
{
"jsonrpc": "2.0",
"method": "web_links",
"params": {
"url": "https://ostk.ai"
},
"id": 42
} View Raw Help Details
Extract all links from a web page
Usage: ostk web-links [OPTIONS] <URL>
Arguments:
<URL> Fully-qualified URL
Options:
--json Emit JSON
-v, --verbose Print info-level kernel logs to stderr
-h, --help Print help
Read a web page and extract its text content
// Options & Arguments
// Execution Context
This verb executes within Landlock sandbox configurations and registers in the audit ledger.
// JSON-RPC Request
{
"jsonrpc": "2.0",
"method": "web_read",
"params": {
"url": "https://ostk.ai/docs"
},
"id": 42
} View Raw Help Details
Read a web page and extract its text content
Usage: ostk web-read [OPTIONS] <URL>
Arguments:
<URL> Fully-qualified URL
Options:
--json Emit JSON
-v, --verbose Print info-level kernel logs to stderr
-h, --help Print help
Check the HTTP status and headers of a URL
// Options & Arguments
// Execution Context
This verb executes within Landlock sandbox configurations and registers in the audit ledger.
// JSON-RPC Request
{
"jsonrpc": "2.0",
"method": "web_status",
"params": {
"url": "https://ostk.ai/healthz"
},
"id": 42
} View Raw Help Details
Check the HTTP status and headers of a URL
Usage: ostk web-status [OPTIONS] <URL>
Arguments:
<URL> Fully-qualified URL
Options:
--json Emit JSON
-v, --verbose Print info-level kernel logs to stderr
-h, --help Print help
Launch the terminal UI
// Options & Arguments
// Execution Context
Operator commands combine multiple ABI primitives and run with human credential authority.
// Coordination Wrapper
This is a compound operator overlay command. It executes entirely in userspace to configure the environment, spin up TUI dashboard screens, or orchestrate credentials, and does not map to a single JSON-RPC ABI verb.
View Raw Help Details
Launch the terminal UI
Usage: ostk tui [OPTIONS]
Options:
-v, --verbose Print info-level kernel logs to stderr
-h, --help Print help
Look up a needle, hay, thread, status, or clock
// Options & Arguments
// Execution Context
Operator commands combine multiple ABI primitives and run with human credential authority.
// Coordination Wrapper
This is a compound operator overlay command. It executes entirely in userspace to configure the environment, spin up TUI dashboard screens, or orchestrate credentials, and does not map to a single JSON-RPC ABI verb.
View Raw Help Details
Look up a needle, hay, thread, status, or clock
Usage: ostk show [OPTIONS] <TARGET>
Arguments:
<TARGET> What to show: needle ID (→NNN), needles, hay, threads, status, clock
Options:
--json Output as JSON
-v, --verbose Print info-level kernel logs to stderr
-h, --help Print help
Print the attribution chain for a needle, commit, or spec
// Options & Arguments
// Execution Context
Operator commands combine multiple ABI primitives and run with human credential authority.
// Coordination Wrapper
This is a compound operator overlay command. It executes entirely in userspace to configure the environment, spin up TUI dashboard screens, or orchestrate credentials, and does not map to a single JSON-RPC ABI verb.
View Raw Help Details
Print the attribution chain for a needle, commit, or spec
Usage: ostk trace [OPTIONS] <TARGET>
Arguments:
<TARGET> Needle ID (`→NNN`), commit hash, or spec path
Options:
-v, --verbose Print info-level kernel logs to stderr
-h, --help Print help
Append a decision to the decision log
// Options & Arguments
// Execution Context
Operator commands combine multiple ABI primitives and run with human credential authority.
// Coordination Wrapper
This is a compound operator overlay command. It executes entirely in userspace to configure the environment, spin up TUI dashboard screens, or orchestrate credentials, and does not map to a single JSON-RPC ABI verb.
View Raw Help Details
Append a decision to the decision log
Usage: ostk decide [OPTIONS] <KEY> <VALUE>
Arguments:
<KEY> Decision key (snake_case identifier)
<VALUE> Decision value (the rationale or content)
Options:
--reason <REASON> Optional reason explaining why the decision was made
-v, --verbose Print info-level kernel logs to stderr
-h, --help Print help
Create a git commit with spec, section, and needle attribution
// Options & Arguments
// Execution Context
Operator commands combine multiple ABI primitives and run with human credential authority.
// Coordination Wrapper
This is a compound operator overlay command. It executes entirely in userspace to configure the environment, spin up TUI dashboard screens, or orchestrate credentials, and does not map to a single JSON-RPC ABI verb.
View Raw Help Details
Create a git commit with spec, section, and needle attribution
Usage: ostk commit [OPTIONS] --message <MESSAGE>
Options:
-m, --message <MESSAGE> Commit message description
--spec <SPEC> Spec name (file in docs/spec/, without .md)
--section <SECTION> Section within the spec
-v, --verbose Print info-level kernel logs to stderr
--bead <BEAD> Needle ID to attribute (deprecated: use --needle)
--needle <NEEDLE> Needle ID to attribute (canonical; --bead is a deprecated alias)
--agent <AGENT> Agent name [default: orchestrator]
-h, --help Print help
File a bug or feature request
// Options & Arguments
// Execution Context
Operator commands combine multiple ABI primitives and run with human credential authority.
// Coordination Wrapper
This is a compound operator overlay command. It executes entirely in userspace to configure the environment, spin up TUI dashboard screens, or orchestrate credentials, and does not map to a single JSON-RPC ABI verb.
View Raw Help Details
File a bug or feature request
Usage: ostk should [OPTIONS] [DESCRIPTION]...
Arguments:
[DESCRIPTION]... What ostk should do (natural language)
Options:
--no-refine Skip AI refinement — use dumb label inference only
-v, --verbose Print info-level kernel logs to stderr
-h, --help Print help
Operate on the needle pipeline
// Options & Arguments
// Execution Context
Operator commands combine multiple ABI primitives and run with human credential authority.
// Coordination Wrapper
This is a compound operator overlay command. It executes entirely in userspace to configure the environment, spin up TUI dashboard screens, or orchestrate credentials, and does not map to a single JSON-RPC ABI verb.
View Raw Help Details
Operate on the needle pipeline
Usage: ostk work [OPTIONS] <COMMAND>
Commands:
pull Claim the next available needle and begin work
hay Capture a thought into the hay pile, or list clustered hay
compile Triage hay into needles, or keep as hay
index Re-index hay and drafts for semantic search
add Create a needle with title, priority, AC, tags, and edges
close Close a needle with an optional reason
release Release a claimed needle so it can be re-dispatched
promote Change a needle's priority
edit Edit fields on an existing needle
link Add a relation edge between a needle and a target
list List needles, optionally filtered by status or priority
next Show or claim the next available task
depends Show the dependency graph for a needle
refine Validate, link, and assess a list of needles
compound Append intent text to a needle to densify it
radiate Show frontier rings around a high-degree needle
sphere Show sphere digest for a needle — members, joints, hay
near Find needles and hay by concept — neighborhood discovery
unlink Remove a joint between two needles
activate Pre-flight briefing for a needle — sphere, blockers, hay
lineage Resolve an Ask-pending session lineage
related Find semantically related code symbols
compounds Show highest-compounding needles
Options:
-v, --verbose Print info-level kernel logs to stderr
-h, --help Print help
Sign, rotate, migrate, and revoke trust keys and primefiles
// Options & Arguments
// Execution Context
Operator commands combine multiple ABI primitives and run with human credential authority.
// Coordination Wrapper
This is a compound operator overlay command. It executes entirely in userspace to configure the environment, spin up TUI dashboard screens, or orchestrate credentials, and does not map to a single JSON-RPC ABI verb.
View Raw Help Details
Sign, rotate, migrate, and revoke trust keys and primefiles
Usage: ostk trust [OPTIONS] <COMMAND>
Commands:
sign Sign HUMANFILE, Agentfiles, or ceremony artifacts
keys List, rotate, or reconcile TrustRoot and PinStore entries
primefile Run the primefile rotation ceremony
migrate-keys Migrate signing keys from GPG to Ed25519
revoke Compute the revocation hash for an Agentfile
attestation OAE legacy-shim attestation telemetry
Options:
-v, --verbose Print info-level kernel logs to stderr
-h, --help Print help
Manage keychain secrets — keys never enter LLM context
// Options & Arguments
// Execution Context
Operator commands combine multiple ABI primitives and run with human credential authority.
// Coordination Wrapper
This is a compound operator overlay command. It executes entirely in userspace to configure the environment, spin up TUI dashboard screens, or orchestrate credentials, and does not map to a single JSON-RPC ABI verb.
View Raw Help Details
Manage keychain secrets — keys never enter LLM context
Usage: ostk secret [OPTIONS] <COMMAND>
Commands:
set Store a secret in the platform keychain
get Retrieve a secret to stdout for subprocess capture
list List secret key names — never values
env Print a shell `export KEY=...` statement
Options:
-v, --verbose Print info-level kernel logs to stderr
-h, --help Print help
Approve or deny privilege escalation requests
// Options & Arguments
// Execution Context
Operator commands combine multiple ABI primitives and run with human credential authority.
// Coordination Wrapper
This is a compound operator overlay command. It executes entirely in userspace to configure the environment, spin up TUI dashboard screens, or orchestrate credentials, and does not map to a single JSON-RPC ABI verb.
View Raw Help Details
Approve or deny privilege escalation requests
Usage: ostk grant [OPTIONS] <COMMAND>
Commands:
list List privilege requests, optionally filtered by status
approve Approve a request with a TTL and optional scope
deny Deny a privilege request with a reason
show Show details for a specific request
types List available privilege request types
Options:
-v, --verbose Print info-level kernel logs to stderr
-h, --help Print help
Recover from incidents — graveyard, repair, rescue, assess
// Options & Arguments
// Execution Context
Operator commands combine multiple ABI primitives and run with human credential authority.
// Coordination Wrapper
This is a compound operator overlay command. It executes entirely in userspace to configure the environment, spin up TUI dashboard screens, or orchestrate credentials, and does not map to a single JSON-RPC ABI verb.
View Raw Help Details
Recover from incidents — graveyard, repair, rescue, assess
Usage: ostk recovery [OPTIONS] <COMMAND>
Commands:
graveyard Generate or apply a recovery plan from an assessment
repair Rebuild OAE envelopes from legacy sigs or TOFU keys
rescue Boot in rescue mode — skip primefile verify
assess Read-only discrepancy report — pair with `--dry-run`
journal-reset Mark an operator-initiated journal reset boundary
Options:
-v, --verbose Print info-level kernel logs to stderr
-h, --help Print help
Sign, verify, rotate, and revoke fleet MANIFESTs
// Options & Arguments
// Execution Context
Operator commands combine multiple ABI primitives and run with human credential authority.
// Coordination Wrapper
This is a compound operator overlay command. It executes entirely in userspace to configure the environment, spin up TUI dashboard screens, or orchestrate credentials, and does not map to a single JSON-RPC ABI verb.
View Raw Help Details
Sign, verify, rotate, and revoke fleet MANIFESTs
Usage: ostk fleet [OPTIONS] <COMMAND>
Commands:
manifest Sign, verify, rotate, or revoke fleet MANIFESTs
profile Verify cold-path Agentfile profiles
Options:
-v, --verbose Print info-level kernel logs to stderr
-h, --help Print help
Show the fleet with pid, ppid, pgid, sid columns
// Options & Arguments
// Execution Context
Operator commands combine multiple ABI primitives and run with human credential authority.
// Coordination Wrapper
This is a compound operator overlay command. It executes entirely in userspace to configure the environment, spin up TUI dashboard screens, or orchestrate credentials, and does not map to a single JSON-RPC ABI verb.
View Raw Help Details
Show the fleet with pid, ppid, pgid, sid columns
Usage: ostk ps [OPTIONS]
Options:
-v, --verbose Print info-level kernel logs to stderr
-h, --help Print help
Render the fleet as a process tree
// Options & Arguments
// Execution Context
Operator commands combine multiple ABI primitives and run with human credential authority.
// Coordination Wrapper
This is a compound operator overlay command. It executes entirely in userspace to configure the environment, spin up TUI dashboard screens, or orchestrate credentials, and does not map to a single JSON-RPC ABI verb.
View Raw Help Details
Render the fleet as a process tree
Usage: ostk pstree [OPTIONS]
Options:
-v, --verbose Print info-level kernel logs to stderr
-h, --help Print help
Send a signal to an agent over the kernel inbox
// Options & Arguments
// Execution Context
Operator commands combine multiple ABI primitives and run with human credential authority.
// Coordination Wrapper
This is a compound operator overlay command. It executes entirely in userspace to configure the environment, spin up TUI dashboard screens, or orchestrate credentials, and does not map to a single JSON-RPC ABI verb.
View Raw Help Details
Send a signal to an agent over the kernel inbox
Usage: ostk kill [OPTIONS] --signal <SIGNAL> <ALIAS>
Arguments:
<ALIAS> Target agent alias
Options:
-N, --signal <SIGNAL> Signal name (SIG…) or number. e.g. `-N SIGTERM`, `-N TERM`, `-N 15`
--reason <REASON> Optional side-channel payload (for SIGREDIRECT / SIGBAIL)
-v, --verbose Print info-level kernel logs to stderr
-h, --help Print help
Send a signal to every agent in a process group
// Options & Arguments
// Execution Context
Operator commands combine multiple ABI primitives and run with human credential authority.
// Coordination Wrapper
This is a compound operator overlay command. It executes entirely in userspace to configure the environment, spin up TUI dashboard screens, or orchestrate credentials, and does not map to a single JSON-RPC ABI verb.
View Raw Help Details
Send a signal to every agent in a process group
Usage: ostk pkill [OPTIONS] --pgid <PGID>
Options:
-g, --pgid <PGID> Process group id (from `ostk ps`)
-N, --signal <SIGNAL> Signal name (SIG-prefixed or short form). Default: SIGTERM [default: SIGTERM]
-v, --verbose Print info-level kernel logs to stderr
-h, --help Print help
Attach to a detachable agent's event stream
// Options & Arguments
// Execution Context
Operator commands combine multiple ABI primitives and run with human credential authority.
// Coordination Wrapper
This is a compound operator overlay command. It executes entirely in userspace to configure the environment, spin up TUI dashboard screens, or orchestrate credentials, and does not map to a single JSON-RPC ABI verb.
View Raw Help Details
Attach to a detachable agent's event stream
Usage: ostk attach [OPTIONS] <NAME>
Arguments:
<NAME> Agent name to attach to
Options:
-v, --verbose Print info-level kernel logs to stderr
-h, --help Print help
Run an agent from an Agentfile
// Options & Arguments
// Execution Context
Operator commands combine multiple ABI primitives and run with human credential authority.
// Coordination Wrapper
This is a compound operator overlay command. It executes entirely in userspace to configure the environment, spin up TUI dashboard screens, or orchestrate credentials, and does not map to a single JSON-RPC ABI verb.
View Raw Help Details
Run an agent from an Agentfile
Usage: ostk run [OPTIONS] <AGENTFILE>
Arguments:
<AGENTFILE> Path to the Agentfile
Options:
--env-passthrough <KEY> Inject an authorized secret into agent env
--runtime <RUNTIME> Runtime: "host" or "qemu" [default: host]
--dry-run Only show what would be done
-v, --verbose Print info-level kernel logs to stderr
-h, --help Print help
Scaffold, list, render, lint, validate, or migrate Agentfiles
// Options & Arguments
// Execution Context
Operator commands combine multiple ABI primitives and run with human credential authority.
// Coordination Wrapper
This is a compound operator overlay command. It executes entirely in userspace to configure the environment, spin up TUI dashboard screens, or orchestrate credentials, and does not map to a single JSON-RPC ABI verb.
View Raw Help Details
Scaffold, list, render, lint, validate, or migrate Agentfiles
Usage: ostk agentfile [OPTIONS] <COMMAND>
Commands:
new Scaffold a new Agentfile from a profile template
list List Agentfiles under .ostk/agents/ and .ostk/profiles/
show Render a parsed Agentfile with its signature status
lint Lint cross-directive rules — RESTART, HEALTHCHECK, FROM-PROFILE
validate Parse, sign-verify, and lint with an outcome envelope
migrate Migrate a legacy Agentfile to the new grammar
Options:
-v, --verbose Print info-level kernel logs to stderr
-h, --help Print help
Draft, promote, or decompose a spec
// Options & Arguments
// Execution Context
Operator commands combine multiple ABI primitives and run with human credential authority.
// Coordination Wrapper
This is a compound operator overlay command. It executes entirely in userspace to configure the environment, spin up TUI dashboard screens, or orchestrate credentials, and does not map to a single JSON-RPC ABI verb.
View Raw Help Details
Draft, promote, or decompose a spec
Usage: ostk doc [OPTIONS] <COMMAND>
Commands:
draft Create a new draft markdown document
promote Promote a draft to a spec
decompose Decompose a spec or needle into sub-needles
Options:
-v, --verbose Print info-level kernel logs to stderr
-h, --help Print help
Run the kernel server on `--transport mcp` or `--transport uds`
// Options & Arguments
// Execution Context
Operator commands combine multiple ABI primitives and run with human credential authority.
// Coordination Wrapper
This is a compound operator overlay command. It executes entirely in userspace to configure the environment, spin up TUI dashboard screens, or orchestrate credentials, and does not map to a single JSON-RPC ABI verb.
View Raw Help Details
Run the kernel server on `--transport mcp` or `--transport uds`
Usage: ostk serve [OPTIONS] [COMMAND]
Commands:
embeddings Manage the embedding model — download or status
Options:
--transport <TRANSPORT>
Which transport to bring up. Ignored when a sub-verb (e.g. `embeddings`) is given
Possible values:
- mcp: MCP kernel server on stdio (was `ostk mcp`)
- uds: Kernel daemon on a Unix domain socket (was `ostk daemon`)
[default: mcp]
-v, --verbose
Print info-level kernel logs to stderr
-h, --help
Print help (see a summary with '-h')
Mount the .ostk/ overlay as a read-through filesystem
// Options & Arguments
// Execution Context
Operator commands combine multiple ABI primitives and run with human credential authority.
// Coordination Wrapper
This is a compound operator overlay command. It executes entirely in userspace to configure the environment, spin up TUI dashboard screens, or orchestrate credentials, and does not map to a single JSON-RPC ABI verb.
View Raw Help Details
Mount the .ostk/ overlay as a read-through filesystem
Usage: ostk vfs [OPTIONS] <COMMAND>
Commands:
mount Mount the VFS at the given path — blocks until unmounted
unmount Unmount the VFS at the given path
status Report current VFS mount status
unmount-stale Force-unmount stale FUSE entries with dead daemons
Options:
-v, --verbose Print info-level kernel logs to stderr
-h, --help Print help
List, call, or serve fcp device drivers
// Options & Arguments
// Execution Context
Operator commands combine multiple ABI primitives and run with human credential authority.
// Coordination Wrapper
This is a compound operator overlay command. It executes entirely in userspace to configure the environment, spin up TUI dashboard screens, or orchestrate credentials, and does not map to a single JSON-RPC ABI verb.
View Raw Help Details
List, call, or serve fcp device drivers
Usage: ostk driver [OPTIONS] <COMMAND>
Commands:
list List configured device drivers
call Call a tool on a device driver with key=value args
serve Run a device driver on a Unix domain socket
Options:
-v, --verbose Print info-level kernel logs to stderr
-h, --help Print help
Pack, unpack, or verify a signed portable OS package
// Options & Arguments
// Execution Context
Operator commands combine multiple ABI primitives and run with human credential authority.
// Coordination Wrapper
This is a compound operator overlay command. It executes entirely in userspace to configure the environment, spin up TUI dashboard screens, or orchestrate credentials, and does not map to a single JSON-RPC ABI verb.
View Raw Help Details
Pack, unpack, or verify a signed portable OS package
Usage: ostk bail [OPTIONS] <COMMAND>
Commands:
pack Pack a signed portable OS-state package
unpack Unpack a bail — verify signature and apply state
verify Verify a bail's signature without unpacking
Options:
-v, --verbose Print info-level kernel logs to stderr
-h, --help Print help
Manage the kernel mlx_lm.server
// Options & Arguments
// Execution Context
Operator commands combine multiple ABI primitives and run with human credential authority.
// Coordination Wrapper
This is a compound operator overlay command. It executes entirely in userspace to configure the environment, spin up TUI dashboard screens, or orchestrate credentials, and does not map to a single JSON-RPC ABI verb.
View Raw Help Details
Manage the kernel mlx_lm.server
Usage: ostk mlx [OPTIONS] <COMMAND>
Commands:
status List tracked mlx_lm.server instances and their health
start Spawn an mlx_lm.server instance
stop Send SIGTERM to a tracked instance, or all with `--all`
log Tail the mlx_lm.server log for a port
models List MLX models cached under ~/.cache/huggingface/hub
Options:
-v, --verbose Print info-level kernel logs to stderr
-h, --help Print help
Operator supervisor for llmos-machined (Unix only)
// Options & Arguments
// Execution Context
Operator commands combine multiple ABI primitives and run with human credential authority.
// Coordination Wrapper
This is a compound operator overlay command. It executes entirely in userspace to configure the environment, spin up TUI dashboard screens, or orchestrate credentials, and does not map to a single JSON-RPC ABI verb.
View Raw Help Details
Operator supervisor for llmos-machined (Unix only)
Usage: ostk machined [OPTIONS] <COMMAND>
Commands:
start Start the machined supervisor in the foreground
stop Send `SIGTERM` to the running machined supervisor
status Print machined supervisor status
fleets List adopted project daemons (fleet view)
cert Cert ceremonies (`issue`, `issue --renew`, `issue --renew --seq=N`)
claim-shared-root Force-claim a project root whose `.ostk/state/machined_lock.json` sentinel was written by a foreign `machine_id` (spec §9.8)
peers Federation peer registry at `~/.ostk/peers.toml` (§5.4 + §3.4). Track F (→1722)
Options:
-v, --verbose Print info-level kernel logs to stderr
-h, --help Print help
Print platform helpers, IPC endpoints, and gate leakage
// Options & Arguments
// Execution Context
Operator commands combine multiple ABI primitives and run with human credential authority.
// Coordination Wrapper
This is a compound operator overlay command. It executes entirely in userspace to configure the environment, spin up TUI dashboard screens, or orchestrate credentials, and does not map to a single JSON-RPC ABI verb.
View Raw Help Details
Print platform helpers, IPC endpoints, and gate leakage
Usage: ostk inspect [OPTIONS] <COMMAND>
Commands:
platform Print platform info: OS, helper implementations, IPC endpoints, gate leakage. Exits 0
Options:
-v, --verbose Print info-level kernel logs to stderr
-h, --help Print help
Profile the ISA — opcodes, tokens, TTFT, generation, drift
// Options & Arguments
// Execution Context
Operator commands combine multiple ABI primitives and run with human credential authority.
// Coordination Wrapper
This is a compound operator overlay command. It executes entirely in userspace to configure the environment, spin up TUI dashboard screens, or orchestrate credentials, and does not map to a single JSON-RPC ABI verb.
View Raw Help Details
Profile the ISA — opcodes, tokens, TTFT, generation, drift
Usage: ostk profile [OPTIONS] <COMMAND>
Commands:
abi Validate opcodes against S7.2 cost budgets (S8.4 gate)
tokens Per-turn token budget breakdown (S9, §5.5.1 TurnFrame.tokens)
ttft TTFT and generation latency histogram (S9)
gen Generation-phase throughput tokens/s (S9)
offenders Top-N commands by token cost -- ->1495 hook (S9)
cache Cache hit rate + prefix-invalidation events (S2.7, S9). →1550: --policy/--since/--until filters, --group-by for A/B
emit Emission-cost attribution per EmitCategory (→1528 §2 sized-for-little)
drift Cache drift analysis between two api.call rows (→1544)
sessions Fleet session accounting: message counts + token/cost estimates (→1561)
Options:
-v, --verbose Print info-level kernel logs to stderr
-h, --help Print help
Plan a CONTROL/REGISTER/JUDGE validation phase from a corpus
// Options & Arguments
// Execution Context
Operator commands combine multiple ABI primitives and run with human credential authority.
// Coordination Wrapper
This is a compound operator overlay command. It executes entirely in userspace to configure the environment, spin up TUI dashboard screens, or orchestrate credentials, and does not map to a single JSON-RPC ABI verb.
View Raw Help Details
Plan a CONTROL/REGISTER/JUDGE validation phase from a corpus
Usage: ostk validate [OPTIONS] --phase <PHASE>
Options:
--phase <PHASE> Validation phase number
--corpus <CORPUS> Path to corpus JSONL file [default: tasks/build-corpus.jsonl]
-v, --verbose Print info-level kernel logs to stderr
-h, --help Print help
Run needle-bench cargo tests, Docker scenarios, or leaderboard
// Options & Arguments
// Execution Context
Operator commands combine multiple ABI primitives and run with human credential authority.
// Coordination Wrapper
This is a compound operator overlay command. It executes entirely in userspace to configure the environment, spin up TUI dashboard screens, or orchestrate credentials, and does not map to a single JSON-RPC ABI verb.
View Raw Help Details
Run needle-bench cargo tests, Docker scenarios, or leaderboard
Usage: ostk bench [OPTIONS] [SCENARIO]
Arguments:
[SCENARIO] Specific scenario name to run
Options:
-l, --list List all available scenarios
--cargo-only Run cargo tests only
-m, --model <MODEL> Model name for Docker scenarios [default: claude-sonnet-4-6]
-v, --verbose Print info-level kernel logs to stderr
-d, --docker Run Docker scenarios only
-s, --score Render leaderboard from existing results
-a, --arm <ARM> Experiment arm: native, kernel, or both (default: both) [default: both]
--all Run all Docker scenarios
--local Use locally cross-compiled ostk binary for kernel arm (skip download)
--driver <DRIVER> Driver for kernel arm: openrouter (default, consistent API) or cpu (optimized native drivers) [default: openrouter]
--keep Keep containers after run for investigation (skip cleanup)
-h, --help Print help
Read .ostk/ state and report boot status
// Options & Arguments
// Execution Context
Operator commands combine multiple ABI primitives and run with human credential authority.
// Coordination Wrapper
This is a compound operator overlay command. It executes entirely in userspace to configure the environment, spin up TUI dashboard screens, or orchestrate credentials, and does not map to a single JSON-RPC ABI verb.
View Raw Help Details
Read .ostk/ state and report boot status
Usage: ostk boot [OPTIONS]
Options:
--bail Fail-fast: exit non-zero if POST check fails or checkpoint is stale
--update-prompt Update the continuation prompt from kernel state
--rescue Diagnostic rescue mode: skip primefile verification and proceed with code-seeded anchors only (docs/spec/primefile-rooted-trust- root-admission.md §Commit 5). Emits a `boot.rescue` audit row
-v, --verbose Print info-level kernel logs to stderr
-h, --help Print help
Bootstrap, repair, or supervise an ostk project
// Options & Arguments
// Execution Context
Operator commands combine multiple ABI primitives and run with human credential authority.
// Coordination Wrapper
This is a compound operator overlay command. It executes entirely in userspace to configure the environment, spin up TUI dashboard screens, or orchestrate credentials, and does not map to a single JSON-RPC ABI verb.
View Raw Help Details
Bootstrap, repair, or supervise an ostk project
Usage: ostk init [OPTIONS] [SUBCOMMAND]
Arguments:
[SUBCOMMAND] Subcommand for Phase 4 (→1566) supervisor: start, stop, status, fleets. When omitted, runs the legacy project initializer (or the Phase 3 flags below) [possible values: start, stop, status, fleets]
Options:
--guided Interactive guided setup with step-by-step configuration
--import Import existing repo: scan git history, README, issues into needles
--from-export <FROM_EXPORT> Seed from an export bail after init
-v, --verbose Print info-level kernel logs to stderr
--attest Attest identity files to Sigstore after GPG signing
--subreap-only Phase 3 (→1565): run as the subreaper process. Acquires .ostk/init.lock, walks .ostk/ on a 60s/5s/event-driven cadence, reaps dead-owned files via same_fs_rename (→1584). Singleton; second invocation errors with a lock conflict
--assess v2.2 §B.2: read-only assessment pass. MUST be paired with `--dry-run` (the bare `--assess` form is reserved for a future alias). Emits a JSON discrepancy report to stdout and exits 0 without mutating state. Run before `ostk graveyard plan` for incident recovery
--dry-run v2.2 §B.2: with `--assess`, perform the walk without any mutation. The discrepancy report is the only side-effect (stdout). Without `--assess`, this flag is reserved
--force With --assess --dry-run (or recovery internals): re-stamp files already migrated
--emit-isa BOOT_ISA_V22_REWRITE_RATIFIED: regenerate the canonical block of `.ostk/.boot/INIT` from live state (primefile keys, kernel version, invariant table, confidence formula). Operator-edited sections outside the GEN_BEGIN/GEN_END markers are preserved. Defaults to stdout; use `--in-place` to write the file
--verify-isa BOOT_ISA_V22_REWRITE_RATIFIED: diff the on-disk `.boot/INIT` generated section against live state. Exits non-zero on drift with a per-directive report. No file mutation
--in-place With `--emit-isa`: write the rendered file to disk instead of printing to stdout
-h, --help Print help
Harness hook handlers — kernel syscall boundary
// Options & Arguments
// Execution Context
Operator commands combine multiple ABI primitives and run with human credential authority.
// Coordination Wrapper
This is a compound operator overlay command. It executes entirely in userspace to configure the environment, spin up TUI dashboard screens, or orchestrate credentials, and does not map to a single JSON-RPC ABI verb.
View Raw Help Details
Harness hook handlers — kernel syscall boundary
Usage: ostk hook [OPTIONS] [ARGS]...
Arguments:
[ARGS]... Subcommand: install, uninstall, pre-tool, post-tool, post-fail, agent-start, agent-stop, session-start, session-end
Options:
-v, --verbose Print info-level kernel logs to stderr
-h, --help Print help
Emit a shell completion script. ostk completions bash > ~/.local/share/bash-completion/completions/ostk ostk completions zsh > "${fpath[1]}/_ostk" ostk completions fish > ~/.config/fish/completions/ostk.fish ostk completions powershell > $PROFILE # append
// Options & Arguments
// Execution Context
Operator commands combine multiple ABI primitives and run with human credential authority.
// Coordination Wrapper
This is a compound operator overlay command. It executes entirely in userspace to configure the environment, spin up TUI dashboard screens, or orchestrate credentials, and does not map to a single JSON-RPC ABI verb.
View Raw Help Details
Emit a shell completion script.
Pipe the output into the appropriate completion file for your shell:
ostk completions bash > ~/.local/share/bash-completion/completions/ostk
ostk completions zsh > "${fpath[1]}/_ostk"
ostk completions fish > ~/.config/fish/completions/ostk.fish
ostk completions powershell > $PROFILE # append
Usage: ostk completions [OPTIONS] <SHELL>
Arguments:
<SHELL>
Target shell
[possible values: bash, zsh, fish, powershell, elvish]
Options:
-v, --verbose
Print info-level kernel logs to stderr
-h, --help
Print help (see a summary with '-h')
Synthesize recall hits into virtual memory pages
// Options & Arguments
// Execution Context
Operator commands combine multiple ABI primitives and run with human credential authority.
// Coordination Wrapper
This is a compound operator overlay command. It executes entirely in userspace to configure the environment, spin up TUI dashboard screens, or orchestrate credentials, and does not map to a single JSON-RPC ABI verb.
View Raw Help Details
Synthesize recall hits into virtual memory pages
Usage: ostk mem-fault-recall [OPTIONS] <QUERY>
Arguments:
<QUERY> Search query
Options:
--intent <INTENT> Retrieval intent: symbol, narrative, trace, general
--limit <LIMIT> Maximum hits to synthesize [default: 10]
--json Emit JSON
-v, --verbose Print info-level kernel logs to stderr
-h, --help Print help
→1801 (W2.1, EPIC →1798): `recall` ISA opcode — fetch a substrate record by address. The shell binding mirrors the MCP tool surface
// Options & Arguments
// Execution Context
Operator commands combine multiple ABI primitives and run with human credential authority.
// Coordination Wrapper
This is a compound operator overlay command. It executes entirely in userspace to configure the environment, spin up TUI dashboard screens, or orchestrate credentials, and does not map to a single JSON-RPC ABI verb.
View Raw Help Details
→1801 (W2.1, EPIC →1798): `recall` ISA opcode — fetch a substrate record by address. The shell binding mirrors the MCP tool surface
Usage: ostk recall [OPTIONS] <ADDR>
Arguments:
<ADDR> Substrate address (`→NNN`, `decision:KEY`, `seq:N`, `path:rel`, `file-...`, or a bare path containing `/`)
Options:
--json Emit JSON
-v, --verbose Print info-level kernel logs to stderr
-h, --help Print help
→1801 (W2.1): `recall_outline` ISA opcode — hierarchical outline (title + children) for a recall address
// Options & Arguments
// Execution Context
Operator commands combine multiple ABI primitives and run with human credential authority.
// Coordination Wrapper
This is a compound operator overlay command. It executes entirely in userspace to configure the environment, spin up TUI dashboard screens, or orchestrate credentials, and does not map to a single JSON-RPC ABI verb.
View Raw Help Details
→1801 (W2.1): `recall_outline` ISA opcode — hierarchical outline (title + children) for a recall address
Usage: ostk recall-outline [OPTIONS] <ADDR>
Arguments:
<ADDR> Substrate address (see `ostk recall --help`)
Options:
--depth <DEPTH> Recursion depth cap (default 1) [default: 1]
--json Emit JSON
-v, --verbose Print info-level kernel logs to stderr
-h, --help Print help
→1801 (W2.1): `recall_search` ISA opcode — substrate-wide search
// Options & Arguments
// Execution Context
Operator commands combine multiple ABI primitives and run with human credential authority.
// Coordination Wrapper
This is a compound operator overlay command. It executes entirely in userspace to configure the environment, spin up TUI dashboard screens, or orchestrate credentials, and does not map to a single JSON-RPC ABI verb.
View Raw Help Details
→1801 (W2.1): `recall_search` ISA opcode — substrate-wide search
Usage: ostk recall-search [OPTIONS] <QUERY>
Arguments:
<QUERY> Search query (literal or regex per `--mode`)
Options:
--scope <SCOPE> Search scope: code, files, work, history, decisions, transcripts, all [default: all]
--mode <MODE> Match mode: hybrid (default), literal, semantic, index, substrate [default: hybrid]
--limit <LIMIT> Maximum hits to return [default: 25]
-v, --verbose Print info-level kernel logs to stderr
--json Emit JSON
-h, --help Print help
→1851: fire a manual journal seal — operator-driven rotation for forensic checkpointing or session-end without a git commit
// Options & Arguments
// Execution Context
Operator commands combine multiple ABI primitives and run with human credential authority.
// Coordination Wrapper
This is a compound operator overlay command. It executes entirely in userspace to configure the environment, spin up TUI dashboard screens, or orchestrate credentials, and does not map to a single JSON-RPC ABI verb.
View Raw Help Details
→1851: fire a manual journal seal — operator-driven rotation for forensic checkpointing or session-end without a git commit
Usage: ostk seal [OPTIONS]
Options:
--reason <REASON> Optional reason for the seal (recorded in the audit row)
-v, --verbose Print info-level kernel logs to stderr
-h, --help Print help