ClaudeCodeMod

All shelves / Mods / Workflow

pi-agent-for-claude

By FazalAAli

pi-agent-for-claude is a Claude Code workflow mod by FazalAAli.

Shows a pi subagent in Claude Code's agent list, streams its tool calls, and can open that agent in a tmux pane.

Draws

Install

The marketplace name is pi-agent-for-claude.

In Claude Code
/plugin marketplace add FazalAAli/pi-agent-for-claude
/plugin install pi-agent-for-claude@pi-agent-for-claude
Open the repo

It runs inside the Claude Code process. The side panel is only what the author's README names. Read the repo before you install, or run claude plugin validate on the plugin folder.

Version
0.1.0
License
MIT
Repo stars
23
Last change
2026-09-18

What it can reach

  • Reaches the network or an outside service
  • Calls another program on this machine

Needs Claude Code 2.1.275 or newer, pi logged in to at least one provider, Node.js, and macOS or Linux. Teammate panes need tmux. Put CLAUDE_CODE_ENABLE_FUNCTION_HOOKS set to 1 and CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS set to 1 under env in ~/.claude/settings.json, and set teammateMode to tmux; the official docs say 2.1.287 and later ignore CLAUDE_CODE_ENABLE_FUNCTION_HOOKS. Install, then restart. The plugin replaces the subagent's model requests with a detached pi --mode json run, so those requests go to whatever provider pi is logged in to. When you name a model, Claude adds a pi-model line, passed to pi --model. Follow-ups continue that pi session. pi streams its text, thinking, and tool calls as the Agent tool's own result. pi runs its own read, bash, edit, and write tools outside Claude Code's permission prompts, so a pi agent can change files without asking. ps detects teammates. A checkout starts with claude --plugin-dir /path/to/pi-agent-for-claude.

The plugin is the repo root. It draws no band or pane of its own: the agent list, the live stream, and the tmux pane are Claude Code's, fed by the pi run. The tool calls it streams are pi's, not Claude's. It denies its own pi_progress tool only when no pi run is active, which the README does not describe as a hold.

Demo

The pi-agent-for-claude section on the author's GitHub page
Screenshot of the author's GitHub page.

What it hooks into

  • session.startWhen a session starts
  • tool.callAround a tool call, where it can hold one
  • agent.spawnWhen a subagent starts
  • turn.stepAt each step of a turn

Read from the on() calls in its hook modules. Open its source under Files to check what each one does.

Files

The author's README and source, 4 files. They load when you open them.

Facts

Author
FazalAAli
Category
Workflow
Marketplace
pi-agent-for-claude
Repo
FazalAAli/pi-agent-for-claude
Version
0.1.0
License
MIT
Repo stars
23
Last change
2026-09-18
Language
TypeScript
Files
8

Other mods in Workflow

stoadigital-stoic-orgDraws the save status of a session pack, can clear the context when it fills, and flags files whose sources changed.trailheadToRvaLDzHolds a commandDraws the ticket map beside the chat and the step above the prompt, and refuses a bad commit, a secret, or an unvetted install.notice-boardHolyGrailDraws a band of notices for the other sessions in this repo, or for every session on the machine.muslim-modsashafizullahDraws the next prayer under the prompt, with adhkar and a verse, and keeps a prompt typed during the salah break until it ends.superclaude-plusplusexcattToasts when a session loads, and checks each edit for conventions and console.log, in a framework of 44 skills and 9 agents.agent-raceOneWave-AIDraws a live race pane for the sessions you put on one track, with tools, files, and tests.inbox-alertsOneWave-AIDraws Gmail, Slack, and Calendar alerts as toasts, a status count, and a pane.cc-mod-parkGGGODLINParks a session with /park, then draws a button in a new session in that folder so you can resume it.vimeskanehiraTurns romaji in the prompt into Japanese, with a candidate band above the prompt, using anthy on this machine.credoMarcel-BichA framework of work items, roles, and modes for running sessions, with an optional band above the prompt for the mode and the item counts.handoff-compacttrytofly94Replaces compaction with a structured handoff that a fork of the session writes, and saves that handoff as a file.agentpanexuanji86Draws a side pane of every subagent, with its current tool, tokens, model, and effort, and its conversation one click away.
All 396 in Workflow