Skip to content

One team. One pulse.Coordinate coding agents across developers and machines.

Each developer runs Claude Code or Codex in their own clone. Pulse coordinates work through shared claims, dependencies and planned files, then takes each item through tests, review and security audit to integration. Regular checked results complete automatically; manual final approval is an option.

Animated Pulse map showing people and agents building, waiting for input, and running checks in parallel.
A morning at a small shop project, in time-lapse. The same view runs in your terminal: pulse map.

Your agents run locally. The team shares the work. ​

Alice starts pulse go on her laptop. Bob starts it in his clone on another machine. Both runners use the same board: they claim items, start agents in separate worktrees, and compare planned files with the work the team already holds. Each person has their own agent slots, permissions, and subscriptions.

Work becomes visible during scoping: /pulse-ba and /pulse-re register drafts before implementation starts. Specs and Plans live on item branches. GitHub hosts the item board and a shared Git branch for confirmed claims and progress. Local actions are saved before background synchronization, with no additional coordination service for your team to operate.

The map shows each person's items, runner phases, and last heartbeat. Detailed tool activity stays in the local clone. Shared revisions serialize competing claims. Planned file reservations reduce overlap, but actual changes can still conflict. Parallel work explains those boundaries and how to hand work over.

Three parts ​

PartWhat it gives you
Operating modelA rhythm for teams where each person works with several agents: three tempos (hourly, daily, every two weeks), a conscious filter that decides what becomes work, roles as hats.
CollaborationA shared board across people and machines, an ordered queue, pulse go to run local agents against it, and pulse map to see the team's work.
Digital Innovation AgentsThe method: one command per step from a raw idea to reviewed code. Business analysis, requirements, plan, build with the spec tests first, review, security audit.

Quick start ​

Pulse runs in Claude Code and Codex, in the terminal and in the VS Code extension; support for GitHub Copilot will follow. You need Python 3.9 or newer, the GitHub CLI gh 2.94 or newer, and a GitHub repository. In Claude Code:

bash
claude plugin marketplace add https://github.com/pssah4/pulse.git
claude plugin install pulse@pssah4-skills

In the Codex CLI:

bash
codex plugin marketplace add pssah4/pulse
codex plugin add pulse@pssah4-skills

Then run /pulse in your project (in Codex, trust the Pulse hooks when Codex asks at its first start, under /hooks in the CLI or one by one on the Hooks page of the IDE extension's settings, and call it $pulse:pulse): it sets Pulse up where it is missing and says what comes next. The VS Code extensions, updates, and removal: Installation.

Where the work lives ​

Business analyses, epics, features and Plans are Markdown files versioned with the code. Each item keeps its spec, Plan and implementation on one published branch. Valid specs permit planning; valid Plans permit building when dependencies and file reservations allow it. Existing Plans and unfinished work are preserved when a run resumes.

Business analyses, specs and Plans are Markdown files on item branches. GitHub holds the item catalog and relationships; a shared Git branch holds claims, holds, results and integration state. pulse new registers work, pulse claim reserves it, and pulse go verifies and integrates results before closing items. pulse status reads a local view. Personal actions enter a durable local outbox; only confirmed synchronization grants team authority.pulse new registers a new itemYour repositoryMarkdown next to the codebusiness analysisepicsfeaturesplansPeople and agentsread the spec,buildpulse claim,pulse gopulse statusfrom a local cacheShared Pulse boardGitHub catalog + Git statetypereadywho has itwaits for whatdone

The pulse commands manage the shared state; nobody edits it by hand. pulse status --json reads a local view. GitHub holds the item catalog and relationships; a shared Git branch holds claims, results and integration state. Local actions enter a durable outbox and gain team authority only after synchronization confirms them. Pulse closes an item after proving its result reached the shared base. Where things live has the details.

What Pulse coordinates ​

Pulse uses GitHub for item types and relationships. Shared Pulse state coordinates who may write and what may integrate when several people each run several agents on one repository.

StepWhat happens
RegisterDraft records expose analysis and specification work before code is written
SelectThe ordered queue considers published specs and Plans, dependencies and files already reserved by the team
ExecuteEach person's runner claims items and starts Claude Code or Codex in local worktrees
VerifyThe runner executes project tests, review and security audit, then publishes the checked result
IntegrateFinal approval binds the exact result and base, automatically by default or under a chosen manual policy; Pulse merges with project hooks

Pulse fits teams that want this workflow across their own machines and are willing to maintain specs and plans. For one person working on one item at a time, issues and branches may be enough. For messaging, shared infrastructure leases, or a configurable skill pipeline, other tools may fit better. Choosing a coordination tool compares those uses with sources and a review date.

The method, one command per step ​

The method in nine steps. /pulse-ba establishes why and for whom; /pulse-re writes epics and features. Valid published specs proceed to planning without early approval. /pulse-build writes spec tests first on the item branch. Tests, review and security audit verify the result; a red gate gets one fix round followed by tests. Green review or audit evidence may carry to a new commit only when its Git tree is identical. If contents change, both checks run again. Pulse publishes the result and integrates it into the shared base with exact head and base binding. Regular results integrate automatically by default; manual final approval is optional. Missing product input holds only dependent work.gapbug, design, requirement/pulse-bawhy, and for whomevidence and input/pulse-rewhat: epics, featurespublished valid specsplanninghow: tasks, files/pulse-re, /pulse-build,or pulse go plans/pulse-buildspec tests first,one branch per featuretestsverifyreviewfresh session/pulse-auditfresh sessionpublished resulthead, base, gatesmergeinto the shared baseauto by defaulta red gate: fix, retest, refresh evidencemanual option

The steps run forward within the authorized task and loop back when the work teaches something new. A red gate gets one fix round, followed by tests. Green review or audit evidence may carry to a new commit only when its Git tree is identical; changed contents require both checks again. pulse go processes the queue. Add a free-text objective directly, such as pulse go finish Epic 4 and investigate the UI problem, to add that work through the same visible item workflow. Explicit scope restrictions bound the run. A start without a terminal uses a managed process. Regular checked results integrate automatically by default; a person may select manual final approval of the exact head and base. Each command has a guide; /pulse tells you where you stand and what comes next.

What Pulse keeps out of your way ​

  • No status in documents. Specs describe the work. Its state (claimed, held, waiting, done) sits on the shared board, and agents ask pulse status instead of reading a backlog file.
  • No rules that only work when someone types a command. The rules reach every agent session and every subagent automatically.
  • No bookkeeping by prompt. Claims, dependencies, the backlog, and the checks are scripts, so no model has to remember them.