claude-code-warp plugin
A Warp plugin for Claude Code that sends native notifications when a task ends, a permission is requested or Claude waits for you
- 238 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- Hooks run shell scripts on every event and read the session transcript to extract the prompt and answer for the notification.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add plugins/claude-code-warpDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Hooks run shell scripts on every event and read the session transcript to extract the prompt and answer for the notification.
This is third-party code. Review the repository files before installing.
What it does
The plugin ties Claude Code to the Warp terminal. It subscribes to session events through hooks and passes them to Warp as structured JSON over OSC 777 escape sequences sent to `warp://cli-agent`. Warp turns them into notifications in its notification center and system alerts. A notification fires in three cases: Claude Code finishes a task, waits for your input (background agents included) or asks permission to run a tool. The completion message shows your prompt and the Claude answer, plus how many background tasks and scheduled wakeups are still pending. A permission request carries the tool name and a preview of its input. Beyond notifications, the plugin reports state changes to Warp: prompt submitted, tool finished. Warp draws inline status indicators in session blocks from those signals. Warp clients older than the protocol get plain-text notifications.
Who it is for. Developers who run Claude Code inside the Warp terminal and switch to other windows while the agent works on a long task.
Good fit when
- A task runs for ten minutes and you want to work in a browser instead of watching the terminal.
- Claude Code often stops at a permission prompt and the session idles without a signal.
- Background agents run in the session and you need to know when they wait for an answer.
- You want Claude Code status indicators in Warp blocks.
Not a fit when
- You use another terminal: the signals are addressed to Warp only.
- You need notifications in a messenger or on a phone: the plugin sends them only to Warp.
- `jq` is not installed and you would rather not add it: the hooks need it.
Example request
Run the test suite and notify me in Warp when you finish or need my permission.Limitations
It works only in the Warp terminal on macOS, Linux or Windows and only with Claude Code. The hook scripts parse JSON with `jq`, so install it first, for example with `brew install jq`. After installation restart Claude Code or run `/reload-plugins`, otherwise the plugin stays off. The plugin version in `plugin.json` is checked by the Warp client, which flags an outdated plugin as an old installation. Sounds and system alert settings live in Warp itself; the plugin does not change them.
How to disable. Run `/plugin uninstall warp@claude-code-warp`, then `/plugin marketplace remove claude-code-warp`.
FAQ
How do I install the Warp plugin in Claude Code?
Run `/plugin marketplace add warpdotdev/claude-code-warp`, then `/plugin install warp@claude-code-warp` and restart Claude Code or run `/reload-plugins`.
Which events trigger notifications?
Task completion, waiting for input (`idle_prompt` and `agent_needs_input`) and a tool permission request. Prompt submission and tool completion only update the session status.
What else is needed besides Warp and Claude Code?
The `jq` utility for JSON parsing, installed with `brew install jq` or the system package manager.
How do I tune sounds and notification style?
Through Warp notification settings. The plugin needs no configuration and has no options of its own.
What does the `oz-harness-support` plugin in this repository do?
It is for Claude Code inside Warp Oz cloud agents and is installed in those environments automatically, so you do not install it by hand.
Discussion
No questions or reviews yet.
Related
PluginsAgent Notifications is an alert plugin that includes project and branch context in Claude Code and Codex desktop messages.
WakaTime plugin for Claude Code tracks time spent working with AI and lines the agent wrote, and shows them on the dashboard
A Claude Code panel for several projects: statuses, button decisions, Git, PR, CI and usage limits in one window.
Claude Code hooks for macOS: a notification returns you to the original terminal window, and a push reaches your phone when idle.
Plugin for Claude Code, Codex and omp that gathers an agent's questions and findings into one list with quick actions.
A macOS menu bar indicator that shows whether Claude Code is thinking, waiting for your permission and how long the current turn has run
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Repository stars | Main difference |
|---|---|---|---|
| claude-code-warp (this card) | no | 238 | |
| Code-Notify | no | 291 | Code-Notify sends system notifications from several agents, while this plugin hands events only to Warp and drives status indicators in its UI. |
| cc-notifier | no | 112 | cc-notifier notifies from Claude Code in a generic terminal, while here notifications and statuses are built into Warp. |
README in short
The repository ships the official Warp plugin for Claude Code as a marketplace. The SessionStart, Stop, Notification, PermissionRequest, UserPromptSubmit and PostToolUse hooks collect session data and send it to Warp. A separate plugin for Oz cloud agents sits next to it.