AIPass/src/aipass/devpulse/README.md

← Back to AIPass

DevPulse

Orchestration hub for AIPass. Plans, coordinates, dispatches. Never the builder.

DevPulse is the central coordination branch. It does not ship features of its own — it works with the user on design, dispatches real work to branch specialists, tracks plans and memory, and keeps the system moving. If a task belongs to another branch, DevPulse emails that branch and waits for the reply.

Start here

You want to	Read
Install, update, uninstall, or troubleshoot	SETUP.md
What's happening right now	STATUS.local.md
Identity, memory, session history	.trinity/
Diagnostic scanners	tools/
Branch health audits	branch_audits _only/
Active plans	drone @flow list open

Invoke

cd src/aipass/devpulse
claude

Say "hi" and DevPulse picks up where the last session left off.

Role in one line

Designer, orchestrator, and light builder — the user's primary AI collaborator. Builds its own things directly (modules, plans, memories, design docs). Ventures into other branches to investigate, debug, run tests, and fix small bugs — CWD stays devpulse. Delegates heavy multi-file builds and full branch rebuilds to sub-agents via dispatch.

Architecture

src/aipass/devpulse/
├── .trinity/                    # Identity & memory
├── .aipass/                     # Branch prompt
├── .ai_mail.local/              # Mailbox
├── apps/
│   ├── devpulse.py              # Entry point — auto-discovers modules
│   ├── modules/
│   │   ├── feedback.py          # Personal feedback mailbox routing
│   │   └── watchdog.py          # Directed wake system routing
│   └── handlers/
│       ├── feedback/            # Feedback inbox, compose, storage
│       └── watchdog/            # Agent, timer, schedule, registry handlers
├── tests/                       # 130+ tests (watchdog + feedback)
├── docs/                        # Transition notes, research
├── docs.local/                  # Local-only docs (gitignored)
└── STATUS.local.md              # Current work beacon

Commands

Devpulse commands are accessed via drone @devpulse <command>:

• watchdog agent @target — monitor a dispatched agent until it finishes
• watchdog timer <seconds> — simple countdown timer
• watchdog schedule <HH:MM> — wait until a specific time
• watchdog status — show active watchdogs
• watchdog cancel <id> — cancel a running watchdog
• watchdog list — list all watchdog entries
• feedback — inbox summary
• feedback inbox — list all feedback messages
• feedback view <id> — read a message
• feedback reply <id> "msg" — reply to sender
• feedback send "subject" "body" — receive feedback from another agent

Integration Points

Depends On

drone (routing), prax (logging), cli (display), ai_mail (dispatch), seedgo (audits), flow (plans)

Provides To

All branches via dispatch orchestration. Watchdog monitoring for any dispatched agent. Feedback channel for cross-project communication.

Last Updated: 2026-04-24

---

← Back to AIPass