Local-first AI agent board for builders who want AI help inside their real task workflow.

Run it locally in one command:

npx draftmora

Draftmora turns messy notes into structured, status-aware tasks. Chat with the agent, approve proposed board changes before anything is applied, and keep SQLite-backed execution history next to the work.

It is built for indie builders, maintainers, and operators who want AI planning without moving project data into another hosted project-management system.

Use Draftmora when you want to:

• Capture rough project ideas before they disappear.
• Ask an agent to break messy work into clear next tasks.
• Approve suggested board changes explicitly.
• Keep board data, task history, and memory files local.

New contributors can start with good first issue tickets for CLI polish, setup notes, docs, and platform smoke checks.

• Start with messy notes and finish with a status-aware task board.
• Use agent chat to propose task changes before anything is applied.
• Keep project data local by default in SQLite and plain memory files.
• Connect OpenAI from the app when account auth is available, or use an API key.
• Prepared with a real npm CLI, Fastify API, React UI, and CI validation.

• Local-first AI agent board with SQLite storage.
• Task status, priority, focus area, tags, and execution history.
• OpenAI account auth through the app settings, with API-key fallback.
• Agent chat with task proposals and explicit memory writes.
• Durable local memory files: USER.md and MEMORY.md.
• React, Vite, TypeScript, Fastify, shadcn/Radix UI, and Vitest.

1. Capture rough work as a draft.
2. Add priority, focus area, tags, and notes.
3. Ask the agent to break down work, propose next tasks, or plan follow-ups.
4. Approve proposed changes explicitly and track execution history on the board.

• Node.js 24 is recommended. Node.js 22.14 or newer remains supported.
• npm 11 or newer.
• Optional: an OpenAI account connection for supported account-auth models, or OPENAI_API_KEY for API-key backed task execution.

Run from npm:

npx draftmora

Then open http://127.0.0.1:4141.

Or run from a local checkout:

git clone https://github.com/afurm/draftmora.git
cd draftmora
npm install
npm run dev

Open http://localhost:5173.

The API runs on http://127.0.0.1:4141 by default. Local board data is stored in ./data/board.db.

Copy .env.example to .env when you need local overrides:

cp .env.example .env

Example local override:

WEB_PORT=3000
API_PORT=3001
BOARD_DB_PATH=./data/board.db
OPENAI_API_KEY=
OPENAI_BASE_URL=https://api.openai.com/v1
OPENAI_ORG_ID=
OPENAI_PROJECT_ID=

WEB_PORT controls the Vite dev and preview server. API_PORT controls the Fastify API and the packaged npx draftmora server. Without these variables, the dev web server uses 5173 and the API uses 4141. The older PORT variable still works as an API port fallback when API_PORT is not set.

Open Settings in the app to choose an auth mode:

• OpenAI account auth: connect an eligible OpenAI account/subscription from the app, without pasting an API key.
• API-key mode: save a key locally or provide OPENAI_API_KEY through the environment.

The OpenAI settings screen also supports advanced request controls for model behavior and transport: max output tokens, temperature, reasoning effort, reasoning summaries, text verbosity, request timeout, retries, retry delay, prompt cache retention, and Codex transport. In API-key mode you can also set OpenAI organization/project headers in the app or through OPENAI_ORG_ID and OPENAI_PROJECT_ID.

API keys, OAuth tokens, SQLite databases, build output, and dependency folders should not be committed.

Run the same validation before opening a PR or pushing release changes:

npm audit
npm run typecheck
npm test
npm run build
npm pack --dry-run

Draftmora is published on npm as draftmora. The package includes the built Fastify server and Vite client assets.

npx draftmora

Or install it globally:

npm install -g draftmora
draftmora

The package starts on http://127.0.0.1:4141 and stores data in ./data/board.db from the directory where the command is run. Set BOARD_DB_PATH when you want a fixed database location.

Release notes are tracked in CHANGELOG.md.

Draftmora is designed as a personal, local-first app. The Fastify API binds to 127.0.0.1 by default and assumes the local operator is trusted. Do not expose the API or Vite dev server to the public internet without a separate auth, firewall, VPN, or reverse-proxy policy.

Project memory is plain text in USER.md and MEMORY.md. Treat those files as local operator state and review them before publishing a branch.

Draftmora uses a built-in local memory pattern:

• USER.md stores durable user preferences and profile facts.
• MEMORY.md stores durable agent and project notes.
• Entries are compact plain text separated with §.
• There is no Memory page or dated memory log.
• Chat turns run through an automatic durable-memory review; explicit "remember" requests are high-confidence save candidates, but memory is inferred from meaning rather than fixed wording.
• Successful task executions also run the same fail-open memory review for durable project notes.
• Memory review uses the selected OpenAI model, so there is no separate memory model setting to configure.

The interface is tuned for a dense SaaS dashboard workflow: left rail navigation, status-aware board columns, compact task cards, a responsive command header, and settings for focus areas.