@future-ux/agent-map
v1.0.6
Published
Local canvas for user journeys, kanban, flows, and project planning — with MCP tools for AI agents
Maintainers
Readme
agent-map
Install agent-map in any project folder; maps and settings live in .future-ux/ on your machine. Cursor and other agents connect over MCP to read and edit maps as markdown.
npx @future-ux/agent-map| Service | URL | |--------|-----| | Canvas | Runs at http://localhost:3333 | | MCP | Runs at http://localhost:3334/mcp |
Features
- User journeys: swimlanes and stages, resizable columns, touchpoints
- Kanban: column boards with lane colours on the same dot-grid canvas
- Freestyle flows: freeform nodes and edges
- Project canvas: guided grid for goals, activities, outcomes
- Figma: frame previews on nodes (OAuth; tokens stay local)
- MCP: global read-only mode and per-map “ready for agent” gates
Quick start (dev dependency)
npm install -D @future-ux/agent-map
npx agent-map.future-ux/ layout
.future-ux/
├── config.json
├── journeys/*.journey.json
├── flows/*.flow.json
├── kanban/*.kanban.json
├── project-canvas/*.project-canvas.json
└── …Git: add .future-ux/ to .gitignore before pushing, it can hold Figma OAuth tokens. See GUIDE.md § Git and secrets.
Agent permissions
| Control | Behaviour | |---------|-----------| | Read only (header) | MCP write tools blocked globally (default) | | Ready for agent (per map) | Agents can read but not edit until enabled | | Write access | Read only off and map marked ready |
Docs in your project (after npm install)
Installed package path (example):
node_modules/@future-ux/agent-map/
| File | Purpose | |------|---------| | README.md | Overview (this file) | | GUIDE.md | Run, Figma, CSV import, gitignore | | AGENTS.md | MCP tools and agent workflow |
Cursor / MCP
Point your MCP client at http://localhost:3334/mcp. Example config and tool list: GUIDE.md, AGENTS.md.
Cloud early access
Pro cloud features (online save, collaboration) are in development. Privacy and contact: [email protected].
Development (this package)
cd packages/agent-map
npm install
npm run build # UI → client/dist (runs automatically on publish)
npm start # :3333 + :3334
npm run dev # Vite :5173 with HMR (proxies /api)
npm run test:storeLicense
ISC
