Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.karta.sh/llms.txt

Use this file to discover all available pages before exploring further.

Two karta subcommand groups manage the things you run locally: projects (registered harness apps) and sessions (live conversations on a running server).

​
karta project

A project is a harness application you’ve registered by name so karta run / karta serve can find it. The registry lives under ~/.karta/projects/. 
karta project add ./my-app my-app    # register (name optional; defaults to folder)
karta project list                   # list registered projects
karta project remove my-app          # unregister
CommandArgumentsPurpose
project addpath, optional nameRegister a folder as a runnable project.
project list—Show all registered projects.
project removenameRemove a project from the registry.

​
karta session

Inspect and drive live sessions on a running server (talks to it over HTTP, so karta serve must be up; use --host/--port to point elsewhere). 
karta session list                       # all active sessions
karta session send <id> "status?"        # one-off message
karta session logs <id>                  # message history
karta session interact <id>              # interactive REPL on a session
karta session pause <id>                 # pause the session's instance
karta session resume <id>                # resume from harness storage
CommandArgumentsPurpose
session list—List active sessions.
session sendid, messageSend a single message.
session logsidPrint the captured message history.
session interactidOpen an interactive, streaming REPL.
session pauseidPause the session (pauses its instance).
session resumeid, optional targetResume a session from harness storage.
session resume passes resume=<id> to the harness, so resumption uses the harness’s own persisted thread — Karta doesn’t keep a second copy of history. See Sessions & participants.

​
Typical local loop

1

Register the app

karta project add ./my-app my-app
2

Serve it

karta serve --port 8000
3

Watch and drive sessions

karta session list
karta session interact <id>