Your project remembers now.Every task, decision, and pattern — connected.
Knowns keeps your tasks, docs, and decisions linked and searchable. Your team and AI assistants always have the right context — no re-explaining, no lost knowledge.
Project context is ready.
Task 42 complete. 2/3 spec ACs done. Continue with task 43?
GitHub Stars
Downloads/mo
License
Context disappears. Work repeats.
Without project memory
- —Tasks live in one tool, docs in another, decisions in chat
- —Every session starts with re-explaining the project
- —Handoffs lose context — new people ask the same questions
- —AI assistants guess because they can't see the full picture
- —Good solutions get forgotten and reinvented
With Knowns
- Tasks link to docs, specs, and decisions in one place
- Sessions start with full project state — no pasting needed
- Handoffs include history, decisions, and linked references
- AI reads structured context and knows what 'done' looks like
- Knowledge is extracted and reused through templates
From idea to done, with context intact.
A simple cycle that keeps knowledge connected.
Capture
Write down what needs to happen and what 'done' means.
Link
Connect tasks to docs, specs, templates, and past decisions.
Work
Your AI reads the full context and follows the plan.
Verify
Check acceptance criteria before marking complete.
Remember
Extract patterns and decisions for next time.
Workflow Demos
Real-world examples of using Claude Code with Knowns skills.
Task Workflow
Use /kn-research, /kn-plan, /kn-implement, and /kn-extract to implement dark mode in a Flutter project.
All skills use the /kn-* namespace. View full workflow guide →
Everything you need to keep context
Six capabilities that work together. One connected system.
Tasks
Plan work with acceptance criteria, linked specs, and progress tracking.
Docs
Keep project knowledge searchable, versioned, and close to work.
Templates
Reuse proven workflows instead of starting from scratch.
References
Explicit links between tasks, docs, and decisions. Nothing orphaned.
Search
Find anything by meaning, not just keywords. Semantic search built in.
Agent Context
Give AI assistants structured project memory via MCP integration.
Built for real project handoffs
Knowns helps people and AI agents start from the same context.
Solo Developer
You build projects across multiple sessions. Knowns remembers your architecture decisions, tracks what's done, and gives your AI the full picture every time you start working.
AI-Assisted Team
Multiple people and AI agents working on the same codebase. Knowns ensures everyone — human or AI — works from the same structured context. No conflicting assumptions.
Product & Engineering Handoff
Specs, tasks, and acceptance criteria live in one connected system. When engineering picks up a task, the full context is already there — linked docs, related decisions, and clear definition of done.
How Knowns compares
Most tools cover one slice. Knowns connects them all.
| Knowns | BMAD Method | Spec Kit | Backlog.md | mem0 | Claude Memory | Cursor / Windsurf rules | Repomix | |
|---|---|---|---|---|---|---|---|---|
| Structured tasks with ACs | Story-like | Spec tasks | ||||||
| Linked specs & docs | Partial | Specs only | ||||||
| Semantic search | Partial | |||||||
| Project memory across sessions | Process only | Static rules | ||||||
| Templates & code generation | Rule templates | |||||||
| AI agent context (MCP) | Via integrations | Third-party | Hooks | |||||
| Validation & coverage checks | Process QA | Partial | ||||||
| Web UI (kanban, docs, chat) | API only |
Get started in under a minute
Install, initialize, and your AI assistant is connected.
Prerequisites
Multiple install paths are available including Homebrew, shell script, PowerShell, npm, and `npx`. npm-based installs still need Node.js 20+. Download Node.js
Keeping Skills & Agents Updated
After a new release, update your installation then run:
This keeps your skills and agents always up to date.
Platform-Specific Instructions
Need help? Read the documentation or open an issue
Give your project a memory.
Start with one project. See the difference in your next AI session.
Open source · Local-first · MIT License · No vendor lock-in