guidon

Why Guidon

Most boards track what is being done. Guidon also keeps why: the decision behind a task, what was already tried, and what the team knows about the project. People and AI agents read the same context, so nobody starts from zero.

• Task board. Drag and drop, custom columns, labels, subtasks, recurring tasks, bulk actions and My tasks across projects.
• Context behind the work. Decisions, knowledge base, project memory, roadmap, calendar, whiteboard and moodboard. Each module can be switched on or off per project.
• Built for AI agents. A REST API (OpenAPI) and an MCP server. Claude Code, Cursor, Codex and others can pick up a task, see earlier failed attempts, do the work and hand it back for review.
• Where you already work. Plugins for Unity, Unreal Engine, Godot, Blender, JetBrains and VS Code, a desktop app, a Discord bot and in-game bug reports.
• Yours to run. Self-host with Docker Compose on plain PostgreSQL, with local file storage and optional local AI (Ollama). No limits on a self-hosted instance.

Decisions	Project memory

Get started

	Guidon Cloud	Self-hosted	Development
For	Trying Guidon without running anything	Running it on your own server	Changing Guidon's code
Start	Start free or try the sandbox	./scripts/self-host.sh	npm install && npm run dev
Details	Pricing	docs/self-hosting.md	CONTRIBUTING.md

Self-host in one command

You need Docker with Compose.

git clone https://github.com/Two-Steps-Studio/guidon.git
cd guidon
./scripts/self-host.sh

The script writes a .env with random secrets, builds the image, runs the migrations and waits until the app answers on http://localhost:3000. Then sign up to create the first account. Storage, AI, sign-in providers, backups and upgrades are covered in docs/self-hosting.md.

Connect an AI agent

npx skills add two-steps-studio/guidon

That installs Guidon's task workflow skills (from skills/). To connect an MCP client, see the agent integration guide.

Tech stack

Next.js 16 (App Router, React 19), TypeScript, Tailwind CSS v4, shadcn/ui and PostgreSQL. Pages read data in Server Components and write through Server Actions. The same Row-Level Security policies guard the data on Supabase and on a plain self-hosted PostgreSQL. More in docs/architecture.md.

Repository layout

Path	What's there
src/	The web app: pages, Server Actions, the /api/v1 REST API and the MCP server
src/db/migrations/	Database schema, one numbered SQL file per change (reference)
plugins/	Editor plugins: Unity, Unreal, Godot, Blender, JetBrains, VS Code
desktop/, mobile/, discord-bot/	Desktop app (Tauri), mobile app (Expo), Discord bot
packages/, sdk/	JavaScript SDK, CLI and Python SDK (MIT)
skills/, agent-plugin/	Skills and plugin for AI coding agents
tests/	Plain Node test scripts (npm run test:*)
docs/	Guides, architecture, audits and release notes

Documentation

• User guide: the main workflows in the web app
• Self-hosting, configuration, upgrading, backups
• Architecture
• Importing tasks from CSV, JSON and Trello
• Webhooks, Context API, custom modules
• Roadmap

Contributing

Bug reports, ideas and pull requests are welcome. Start with CONTRIBUTING.md. Report security problems privately as described in SECURITY.md, not in a public issue.

License

The Guidon application is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0-only, see LICENSE). You may run, study, change and self-host it. If you offer a modified version to others over a network, you must share your changes with them under the same licence.

The JavaScript SDK (packages/sdk-js), CLI (packages/cli) and Python SDK (sdk/python) are MIT-licensed; each has its own LICENSE. The Guidon name and logo are not covered by either licence (see useguidon.com/brand).

Made by Two Steps Studio.