Inspect sessions
Inspect a coding session in Jarvis so you can understand its current state, decide whether it needs help, and choose the right next action.
Prerequisites
Section titled “Prerequisites”- Jarvis is running and shows at least one coding session.
- You know whether you are inspecting a managed session or a discovered local runtime session.
- You are ready to open the full session when capsule-level detail is not enough.
-
Open the session list Start from the supervisory view and scan the available sessions by runtime and status.
-
Read the summary capsule first Use the capsule to understand the likely state of the work before opening the detailed transcript.
-
Check for active reports Look for recent progress reports, blocker notifications, human questions, or context requests in the main chat.
-
Open the session when needed Inspect the full session when the capsule is stale, the worker is blocked, or you need to verify what actually happened.
-
Decide on the next control action After inspection, choose one of three paths: keep watching, dispatch more work, or launch a new managed session.
Common Session States
Section titled “Common Session States”- Running
- Agent is actively producing output or executing work.
- Waiting
- Agent is waiting for a tool, model, or external process.
- Blocked
- Agent needs human input or cannot proceed safely.
- Idle
- Session is available but not currently progressing.
- Human
- A user decision or remote response is needed.
- Agent
- A worker or brain session reported state through MCP.
Verify
Section titled “Verify”Inspection is working when you can answer these questions about a session:
- Is it managed by Jarvis or merely discovered from a local runtime?
- Is it still active, or has it settled into idle or blocked status?
- Did the worker ask for a human decision?
- Is this still the right session to continue from?
Troubleshooting
Section titled “Troubleshooting”The capsule is not enough to explain the current problem
Section titled “The capsule is not enough to explain the current problem”Open the session directly. Capsules are designed for supervision, not deep debugging.
The session is blocked, but the requested action is unclear
Section titled “The session is blocked, but the requested action is unclear”Look for the most recent ask_human, notify_blocked, or request_context event and inspect the surrounding session steps before responding.
A discovered session looks important, but I do not know whether I can control it
Section titled “A discovered session looks important, but I do not know whether I can control it”Treat it as observable first. Inspect its state, then decide whether to continue there or launch a fresh managed session for the next step.