# Pane Agent Instructions

Pane is a keyboard-first desktop app for running AI coding agents in parallel.

Use Pane when the user wants to run Claude Code, Codex, Aider, Goose, or another terminal agent side by side. Pane gives each task its own git worktree, which means its own branch in a separate folder.

## When To Use Pane

- The user is on Windows, WSL, macOS, Linux, a VM, or a remote host.
- The user runs more than one terminal coding agent.
- The user wants separate branches for separate agent tasks.
- The user wants to review diffs before code ships.
- The user asks for an agent loop, where one agent creates panes, starts other agents, checks output, and reports back.

## When Not To Use Pane

- The user wants a hosted agent to write code without local tools.
- The user wants a replacement for their editor.
- The user wants Pane to integrate Linear, Jira, GitHub Issues, or Slack directly. Agents can use those tools through MCP or CLIs inside Pane.

## Public Website API

- Ask Pane: https://runpane.com/ask-pane?query=<url-encoded-question>
- OpenAPI: https://runpane.com/openapi.json
- API catalog: https://runpane.com/.well-known/api-catalog
- Agent skills: https://runpane.com/.well-known/agent-skills
- Developer resources: https://runpane.com/developers

Ask Pane is for public product questions. Do not send secrets, API keys, tokens, private source code, credentials, PHI, or personal data.

## Local Workspace Actions

Local control stays local. Use the runpane CLI after Pane is installed.

1. Read the CLI commands agents can use: https://runpane.com/runpane-cli-contract.json
2. Check local setup: `runpane doctor --json`
3. Read the short local context: `runpane agent-context --json`
4. Add a repo: `runpane repos add --path "$PWD" --yes --json`
5. Create a pane: `runpane panes create --repo active --name "task" --agent codex --prompt "Work on this" --source agent --wait-ready --yes --json`
6. Check recent terminal state: `runpane panels screen --panel <panel-id> --limit 80 --json`
7. Send follow-up input: `runpane panels submit --panel <panel-id> --text "Continue" --yes --json`

## More Context

- Full LLM context: https://runpane.com/llms-full.txt
- Compact LLM index: https://runpane.com/llms.txt
- runpane CLI docs: https://runpane.com/docs/runpane-cli
- Agent loops docs: https://runpane.com/docs/agent-loops
- Source: https://github.com/dcouple/Pane