Agent Panel

The Agent Panel is a collapsible right-side panel that runs a full terminal session — Claude Code, OpenCode, or a plain shell — side-by-side with your spec documents and code. It is the primary interface for handing work to AI during Phase 07 (Code Generation) and beyond.

Opening the panel

Click the Agent button in the top-right toolbar, or press Cmd/Ctrl + Shift + A. The panel slides in from the right. Drag the divider to resize it.

Supported agents

RunLogos does not manage agent credentials — set up your API keys in your shell profile before launching.

Dragging file paths

The file tree on the left supports drag-and-drop into the Agent Panel terminal. Drag any file to insert its absolute path at the cursor. This is the fastest way to give the agent context:

> claude "read @/path/to/requirements.md and implement the login endpoint"

You can drag multiple files in sequence to build up a context list.

Working with Comment-to-Prompt

The most effective workflow combines the Markdown editor and the Agent Panel:

1. Open a spec document in the center panel.
2. Highlight a section that needs work.
3. Use Comment-to-Prompt to generate a precise AI instruction.
4. The generated prompt appears in a floating card — click Copy or drag it directly into the Agent Panel.
5. The agent has the exact context it needs without any copy-pasting.

Terminal panel (bottom)

The bottom terminal panel is separate from the Agent Panel and supports multiple tabs. Use it for:

• Running tests (npm test, pytest, etc.)
• Starting dev servers
• Running openlogos verify
• Any shell command that isn't an AI agent session

Clickable error lines: When a test or build fails, error output in the terminal includes file paths and line numbers. Click them to jump directly to that file and line in the center editor.

Multi-tab sessions

Both the Agent Panel and the bottom terminal support multiple tabs. Open a new tab with Cmd/Ctrl + T inside the panel. Each tab is an independent PTY session — run the agent in one tab and a dev server in another.

Typical workflow during Phase 07

1. Open the Spec Chain overview in the center panel.
2. Open the Agent Panel on the right.
3. Start Claude Code: claude
4. Drag requirements.md, openapi.yaml, and the test case docs into the agent.
5. Prompt: "Implement the endpoints defined in openapi.yaml. Use the test cases in logos/resources/test/ as your acceptance criteria."
6. Watch the agent write code in the center panel's file tree.
7. Run tests in the bottom terminal. Click any failing line to jump to the source.

Next step

→ Orchestration Runner