Run kestrel or its ks alias to open the interactive terminal client. The
client connects to Local Core, so sessions, runs, events, and terminal results
use the same durable execution model as Desktop.
kestrel --profile referenceStart in the intended workspace
From a project folder, inspect the binding before opening the client:
kestrel workspace status
kestrel --profile referenceInside the client, /status shows the active profile, session, workspace,
mode, waiting state, and relevant tool configuration. Do not infer those values
from a sample prompt or folder name.
Sessions and history
Use /sessions, /switch, /resume, and /new to move among durable local
sessions. Closing the terminal does not erase the recorded session or its runs.
Local Core owns their persistence under the platform-specific state root
described in Command suite.
Operator control
These commands act on recorded work rather than creating an unrelated session:
| Command | Purpose |
|---|---|
/status | Inspect the current session and wait state |
/resume <name> | Continue a saved session |
/reply <message> | Answer a pending interaction |
/approve or /deny | Resolve a pending approval |
/steer <message> | Add durable guidance to focused work |
/retry [reason] | Retry through operator control |
/stop [message] | Cancel active work and record the operator action |
/operator | Open operator-focused inspection and recovery commands |
Inspect before acting so a reply, approval, retry, or cancellation stays attached to the correct run.
Activity and progress
The terminal keeps conversation content separate from runtime and tool
telemetry. Provider-exposed reasoning is live-only by default. Validated
run.agent_progress events can become durable progress, while generic
run.progress events remain runtime diagnostics.
Profiles and tools
Use /profiles, /model, /mode, /code, and /mcp to inspect the current
configuration. These controls change runtime behavior and tool availability;
they are not display preferences.
Read Profiles, code mode, and MCP before creating a custom profile, and Operator control workflows for server-side equivalents.