The kyora command line: disposable VMs for builds and coding agents, sessions you can move to a VM and back, deploys, and logins you can swap between accounts. TypeScript on Bun.
Status: early development.
Install
Requires Bun 1.2.19 or later on your PATH, and 1.3.14 or later for kyora run and kyora tui (npx will not work).
bun add -g kyora
kyora login
This installs kyora:
kyora vms: disposable VMs. kyora vms run -- cargo build uploads your worktree, runs the command, streams its output and exits with its code; new, ls, shell, exec, push, pull and images cover the rest. See packages/vms/cli.kyora detach moves this repo's coding-agent conversation to a kyora VM and kyora back brings its commits and conversation home.kyora image, kyora deploy and kyora top manage images, deploys and live usage; kyora login signs in to kyora cloud.kyora switch hot-swaps coding-agent logins between accounts. See packages/switch/cli.kyora run and kyora tui start the kyora agent harness (below).
kyora --help lists them all. kyora-vms, the earlier name, is deprecated and still works: kyora-vms <args> is kyora vms <args>.
The agent harness
kyora also ships its own agent harness: a recursive agent runtime in Rust whose Python REPL lets the model call itself from code, so one agent can fan a task out to many. On kyora VMs each of those agents gets its own machine, which takes recursive runs from a laptop to fleet scale. Design notes are in docs/.
Its binary is kyora-harness; kyora run and kyora tui hand off to it. Install it with:
cargo install --locked --git https://github.com/kyora-sh/kyora kyora-cli
Connect MCP servers through [mcp.servers.<name>] in $KYORA_HOME/config.toml (see docs/mcp.md). The TUI demo: kyora tui --demo (see docs/tui.md).
Layout
packages/vms/cli: kyora (and the deprecated kyora-vms);packages/switch/cli: kyora-switch;packages/shared/usage and packages/shared/hostnames: libraries the CLIs bundle;crates/: the agent harness (crates/cli builds kyora-harness).
Build and test
The CLIs (Bun 1.4 or later):
bun install --frozen-lockfile
bunx turbo run build
bunx turbo run check-types
bunx turbo run test
The harness (Rust stable, see rust-toolchain.toml; Python 3.9+ for the REPL tests):
cargo build
cargo test
cargo clippy --workspace --all-targets --locked -- -D warnings
From a checkout, CARGO_BUILD_JOBS=4 cargo run -p kyora-cli -- tui --demo runs the TUI demo.
License: Apache-2.0, see LICENSE. packages/vms/cli/NOTICE names what the CLI bundles.
