Warp integration

May 24, 2026 ยท View on GitHub

tokenjuice install warp inserts a marker-delimited instruction block into Warp's project rules file. New projects use the current git/project root AGENTS.md. If WARP.md already exists in that root, tokenjuice writes there because Warp gives WARP.md priority over AGENTS.md in the same directory. If tokenjuice already manages a Warp block in AGENTS.md, later creating WARP.md does not move that install automatically; install, doctor, and uninstall keep targeting the existing tokenjuice block.

tokenjuice install warp
tokenjuice doctor warp
tokenjuice uninstall warp

By default tokenjuice resolves the nearest git root. Fresh installs write WARP.md when it already exists, otherwise AGENTS.md. Existing tokenjuice Warp blocks are managed in place, so remove and reinstall explicitly if you want to move an older AGENTS.md install into WARP.md. Set WARP_PROJECT_DIR=/path/to/workspace to target a specific workspace in scripts or tests.

The installed block tells Warp to use:

tokenjuice wrap -- <command>

for noisy terminal commands, and to reserve:

tokenjuice wrap --raw -- <command>

for commands where exact output bytes are required.

This is guidance-only. Warp still owns command execution and approval; tokenjuice does not intercept or rewrite Warp tool output.

doctor warp reports ok when the selected project rules file contains the tokenjuice block, includes tokenjuice wrap guidance, and does not advertise the older --full escape hatch. Malformed tokenjuice markers are reported as broken so project instructions are not rewritten unsafely.