Pulse GTM Agents

Pulse GTM Agents is a local end-to-end GTM agent workspace. It turns a company URL into an inferred GTM profile, deterministic research run, scored opportunities, human review actions, feedback events, and playbook memory.

The repo runs without external services. It uses Node's built-in HTTP server, browser fetch, and JSON persistence in data/state.json.

What Works

• Start a GTM research run from a landing page URL
• Infer product, audience, trigger phrases, and engagement boundaries
• Generate deterministic source scan results
• Create comment, post, and competitive-intelligence opportunities
• Filter opportunities by query, type, and status
• Approve, save, teach, or dismiss opportunities
• Persist feedback events and playbook memory rules
• Reset local data from the UI or API
• Run dependency-free API evals

Quick Start

npm run reset
npm run dev

Open:

http://localhost:4173

Scripts

npm run dev      # start local app
npm run start    # same as dev
npm run reset    # reset data/state.json
npm run check    # syntax-check server and client JS

Project Structure

.
├── data
│   └── state.json
├── docs
│   ├── api.md
│   ├── architecture.md
│   ├── data-model.md
│   ├── evals.md
│   └── product-spec.md
├── evals
│   └── e2e.js
├── public
│   ├── app.js
│   ├── index.html
│   └── styles.css
├── server
│   ├── agent-engine.js
│   ├── index.js
│   ├── reset-data.js
│   └── store.js
└── package.json

Core Flow

1. User submits a landing page URL.
2. AgentEngine creates a run and inferred GTM profile.
3. Source adapters produce deterministic source activity.
4. Opportunity templates become scored review items.
5. User reviews each opportunity.
6. Review actions update opportunity status, feedback events, and memory rules.
7. State persists to data/state.json.

Local Data

The app persists state in:

data/state.json

Reset it at any time:

npm run reset

API

See docs/api.md.

Architecture

See docs/architecture.md.