Background
Warp is a coding agent runtime built into a modern terminal. Adding Warp to Observal would let users pull agents, scan installed components, and trace sessions.
Before you pick this up
Only take this issue if you are willing to use Warp as a daily driver for a while to properly test the integration, help maintain support for the runtime semi-long term, and write proper documentation for it.
Implementation guide
Follow docs/adding-an-ide.md for the full file checklist and step-by-step process. Start with Step 1 (Research the IDE) using the official Warp Agent Platform documentation at https://docs.warp.dev/agent-platform/ to determine config paths, MCP format, hook support, and session log locations.
Scope
Add Warp with full IDE support. All coding agent runtimes store session data (JSONL, SQLite, or similar). Part of this issue is figuring out where and how Warp persists sessions, then building the parser so observal reconcile and the trace viewer work correctly. Document your findings in the PR.
Note: PRs without screenshots showing traces in the IDE, and screenshots of skills, hooks, and MCPs installed via Observal working will be automatically closed.
File checklist
See docs/adding-an-ide.md § File Checklist for the full list. At minimum:
| # |
File |
Action |
| 1 |
observal-server/schemas/ide_registry.py |
Add "warp" entry |
| 2 |
observal_cli/ide/warp.py |
New CLI adapter |
| 3 |
observal_cli/ide/load_all.py |
Add import |
| 4 |
observal_cli/ide/__init__.py |
Bump _EXPECTED_ADAPTER_COUNT |
| 5 |
observal-server/services/ide/warp.py |
New server adapter |
| 6 |
observal-server/services/ide/load_all.py |
Add import |
| 7 |
web/src/lib/ide-features.ts |
Add to VALID_IDES, feature matrix, display names |
| 8 |
tests/test_ide_warp.py |
Unit tests for adapter |
Acceptance criteria
Reference
Implementation checklist for IDE support
Please include these updates in the same PR:
observal_cli/cmd_doctor.py: add diagnose, patch, and cleanup coverage for the IDE
observal_cli/layer.py: update IDE_LAYER_CONFIGS and managed-file attribution paths
README.md: add the IDE to the supported IDE list
docs/adding-an-ide.md: keep checklist requirements aligned when needed
Background
Warp is a coding agent runtime built into a modern terminal. Adding Warp to Observal would let users pull agents, scan installed components, and trace sessions.
Before you pick this up
Only take this issue if you are willing to use Warp as a daily driver for a while to properly test the integration, help maintain support for the runtime semi-long term, and write proper documentation for it.
Implementation guide
Follow docs/adding-an-ide.md for the full file checklist and step-by-step process. Start with Step 1 (Research the IDE) using the official Warp Agent Platform documentation at https://docs.warp.dev/agent-platform/ to determine config paths, MCP format, hook support, and session log locations.
Scope
Add Warp with full IDE support. All coding agent runtimes store session data (JSONL, SQLite, or similar). Part of this issue is figuring out where and how Warp persists sessions, then building the parser so
observal reconcileand the trace viewer work correctly. Document your findings in the PR.File checklist
See docs/adding-an-ide.md § File Checklist for the full list. At minimum:
observal-server/schemas/ide_registry.py"warp"entryobserval_cli/ide/warp.pyobserval_cli/ide/load_all.pyobserval_cli/ide/__init__.py_EXPECTED_ADAPTER_COUNTobserval-server/services/ide/warp.pyobserval-server/services/ide/load_all.pyweb/src/lib/ide-features.tsVALID_IDES, feature matrix, display namestests/test_ide_warp.pyAcceptance criteria
observal pull <agent> --ide warpwrites correct config and the agent is usable in Warp.observal scan --ide warpdiscovers installed components.observal doctorreports Warp status.tests/test_constants_sync.pypasses (registries in sync).tests/test_ide_warp.pypasses with at least 4 test cases.Reference
observal_cli/ide/claude_code.py,observal_cli/ide/kiro.pyImplementation checklist for IDE support
Please include these updates in the same PR:
observal_cli/cmd_doctor.py: add diagnose, patch, and cleanup coverage for the IDEobserval_cli/layer.py: updateIDE_LAYER_CONFIGSand managed-file attribution pathsREADME.md: add the IDE to the supported IDE listdocs/adding-an-ide.md: keep checklist requirements aligned when needed