
Knowns CLI is an open-source command-line tool that functions as an AI project memory system, designed for developers and teams who rely on AI assistants. Its core value is eliminating the need to re-explain project context every session. By storing tasks, docs, and decisions in a unified, linked structure, it ensures that both humans and AI agents always start with a complete understanding of the project. The tool is local-first, respects privacy under MIT license, and integrates with AI assistants via the Model Context Protocol. It is particularly useful for solo developers, AI-assisted teams, and product-engineering handoffs where context continuity is critical.
The primary pain point Knowns CLI solves is the fragmentation of project context across disparate tools. Tasks are often managed in one system, documentation in another, and decisions are buried in chat logs. This fragmentation forces every new session—whether by a developer or an AI agent—to start from scratch, leading to wasted time and lost knowledge. Knowns CLI addresses this by providing a central repository where all context is linked and searchable. AI assistants can read the full project state, including acceptance criteria, linked specs, and past decisions, eliminating guesswork and re-explanation. This is especially painful during handoffs when new team members must ask the same questions repeatedly. With Knowns CLI, the entire history is captured and organized, so nothing is forgotten. The result is faster onboarding and more efficient collaboration across the board.
The first major feature group is structured tasks with acceptance criteria. Knowns CLI allows users to define each task with a clear description of what 'done' means, and link it to related specifications and documentation. This feature ensures that work is verified against objective criteria before being marked complete. When an AI agent reads a task, it sees not just the title but the full linked context—the spec, related decisions, and past patterns. This makes AI assistance more accurate and reliable, as it can follow the exact plan defined by the team. Additionally, tasks are organized into a kanban-style view via the Web UI, allowing progress tracking at a glance. The linking between tasks and docs ensures that no piece of knowledge is orphaned. Teams can quickly see the status of each task and the reasoning behind its requirements.
The second feature group is semantic search and explicit references. Semantic search allows users to find any project artifact by meaning, not just keywords. For example, a search for 'database connection pooling' will return the relevant decision log and architecture document, even if those exact words are not present. This capability is powered by AI and works across all stored knowledge. The references feature ensures that every task, doc, and decision has explicit links to related items, creating a web of knowledge that is easy to navigate. Nothing is orphaned, so users never lose context. This is particularly valuable for large projects where information is scattered. By quickly retrieving past solutions and decisions, teams avoid reinventing the wheel. The combination of semantic search and references makes Knowns CLI a powerful memory system that grows more useful over time as more data is added.
admin
The third feature group includes templates and AI agent context via MCP. Templates allow users to capture proven workflows—such as research, planning, implementation, and pattern extraction—and reuse them across projects. These are accessed through the `/kn-*` namespace in tools like Claude Code, making complex tasks repeatable and consistent. The Agent Context feature uses the Model Context Protocol to provide AI assistants with structured project memory automatically. Instead of pasting context manually, the AI reads the full state of tasks, docs, and decisions, enabling it to act with complete awareness. This integration means that every AI session is grounded in real project data, reducing hallucinations and improving output quality. Templates also serve as a form of knowledge sharing, allowing teams to standardize their approaches. The MCP integration is a key differentiator, as it seamlessly connects Knowns CLI to the AI ecosystem.
The workflow of Knowns CLI follows a simple five-step cycle: Capture, Link, Work, Verify, and Remember. In the Capture phase, users write down what needs to happen and clearly define the definition of done. Next, they Link these tasks to relevant docs, specs, templates, and past decisions. During the Work phase, the AI reads the full context and follows the plan. After implementation, the Verify step checks acceptance criteria before marking the task complete. Finally, the Remember phase extracts patterns and decisions for future reuse, closing the loop. This cycle ensures that knowledge is continuously captured and applied, preventing context from being lost between sessions. The structured approach makes it easy to see the status of each task and the rationale behind every decision, fostering transparency and accountability.
Concrete use cases include a solo developer working on a Flutter dark mode implementation across multiple sessions. By using Knowns CLI skills like `/kn-research`, `/kn-plan`, `/kn-implement`, and `/kn-extract`, the AI maintains context of the project state—what's done, what's next, and past decisions. Another use case is an AI-assisted team where multiple agents collaborate on the same codebase. Knowns ensures everyone works from the same structured context, preventing conflicting assumptions. In product-engineering handoffs, the full specification, linked docs, and acceptance criteria are automatically available, reducing onboarding time and ensuring alignment. These scenarios demonstrate how Knowns CLI reduces friction in modern development workflows. The outcome is faster delivery, fewer errors, and less cognitive load for team members. By keeping context intact, Knowns CLI enables a seamless handoff between sessions and between people and AI.
Target users include solo developers who build projects across multiple sessions, AI-assisted teams with multiple agents and humans, and product-engineering handoff scenarios. The tool is platform-agnostic and can be installed via Homebrew, shell script, PowerShell, npm, or npx, requiring Node.js 20+. It is open source under the MIT license with no vendor lock-in, available at GitHub. The tool also offers a Web UI with kanban, docs, and chat capabilities, but its core strength lies in the CLI and MCP integration. Pricing is free as open source, with no hidden costs. Whether you are a solo developer or part of a large team, Knowns CLI helps you stop re-explaining and start building with full context. In summary, Knowns CLI provides persistent AI project memory that connects tasks, docs, and decisions in one searchable system, making it indispensable for anyone seeking to maintain project context across sessions and AI interactions.
Knowns CLI is designed for solo developers who manage projects across multiple AI-assisted sessions, AI-assisted teams where multiple agents and humans collaborate, and product-engineering teams looking to streamline handoffs. It is particularly useful for developers using AI assistants like Claude Code, Cursor, or Windsurf who need persistent project context. Additional roles include technical leads, product managers, and engineering managers who want to reduce context loss and improve team efficiency. The tool is ideal for open-source projects and teams using agile methodologies with acceptance criteria.