PulSeed

Goal-driven orchestration for long-running work.

PulSeed is an AI agent orchestrator for goals that need more than one chat turn.

Naming note: PulSeed is the product name, and pulseed is the CLI and npm package name.

Quick Start

1. Install Node.js 20 or newer.
2. Install the CLI:

npm install -g pulseed

3. Start PulSeed:

pulseed

Then describe what you want in natural language, such as "Increase test coverage to 90%."

Current Architecture

PulSeed uses two layers:

• CoreLoop keeps a goal moving, checks progress, and decides whether to continue, refine, verify, or stop
• AgentLoop handles bounded tool-using work such as task execution, chat turns, and selected runtime phases

State, reports, schedules, and local memory live under ~/.pulseed/.

Security boundary: PulSeed uses approval gates and verification around delegated work, but it does not provide OS-level sandboxing for agent subprocesses. For high-risk or untrusted goals, run PulSeed inside a container or VM. See Security.

Main Command

pulseed

PulSeed is designed so the primary workflow can happen through natural language. Use the lower-level CLI commands only when you need scriptable or diagnostic control.

Docs

• Getting Started
• Docs Index
• Mechanism
• Runtime
• Configuration
• Architecture Map

Release

Run releases from a clean, up-to-date main branch:

npm run release -- 0.4.9

The script updates the package version, runs docs/build/test checks, pushes main, then pushes the matching v* tag. The tag push triggers GitHub Actions to publish to npm through Trusted Publishing.

License

MIT