What your AI shouldhave knowns.

Give your AI persistent memory of your project context with a native Go runtime, code-aware retrieval, smoother workspace switching, and built-in AI Chat on OpenCode. No more repeating yourself.

AI Workflow
YouWork on task 42
AI
Reading task-42: "Add user authentication"
→ Spec: @doc/specs/user-auth | Template: @template/api-auth
Generated from @template/api-auth
Implemented JWT middleware
AC synced: "Users can login"
Time logged: 12m
AISpec coverage: 2/3 ACs done. Open AI Chat or continue with task-43?
152
GitHub Stars
2.5k+
Downloads/mo
26
Forks
MIT
License

Built for faster, project-aware AI work

Native Go performance, code-aware project context, and built-in AI Chat on OpenCode.

Core Features

Native Go performance
Native Go binary for faster startup, lower overhead, and a smoother local developer experience.
Spec-Driven Development
Write specs before code. Tasks auto-link to specs, ACs sync automatically. Verify coverage anytime.
AI Chat with OpenCode
Multi-session AI chat with real-time streaming, model switching, and optional task linking.
Task Management
Create tasks with acceptance criteria, track progress, and manage your backlog from the terminal.
Template System
Generate code with Handlebars templates linked to documentation. AI understands your patterns.
3-layer Memory System
Working, project, and global memory layers keep patterns, decisions, and conventions available across sessions.

Advanced

Import & Sync
Import docs and templates from Git repos, npm packages, or local folders. Keep them synced.
Semantic Search
AI-powered search using vector embeddings. Find tasks and docs by meaning, not just keywords.
Code Intelligence
Search symbols, inspect code relationships, and explore a code-aware graph without leaving your local workflow.
Time tracking built-in
Start/stop/pause timers and generate reports by label, date range, or task without extra tools.
Workspace Switching + Chat
Switch projects more smoothly in the browser while keeping kanban, docs, memory, graph, and AI chat close at hand.
Validate & Quality Checks
Check tasks, docs, and templates for broken refs, missing ACs, and SDD coverage gaps.
The Origin Story

Why Claude keeps writing slop?
Where is my test? Why it messed up my architecture?

The problem isn't the AI. The problem is the context.

Managing a complex project with AI is tough. You are constantly juggling multiple tasks, and one slip-up in your prompt, one missing file or forgotten constraint, leads the AI down a rabbit hole of bad code. We make errors too.

I was tired of doing the same thing every prompt:

  • Paste docs.
  • AI writes code.
  • AI forgets earlier instruction.
  • I realize I forgot to paste the new schema.
  • Start over.

I was spending more time managing the AI's memory and correcting errors than actually building my app.

So, Knowns CLI was born.

I stopped trying to be the manual bridge between my project management and my code. I built a tool that lets the AI read the map itself.

Now, when I say "work on Task 42," I don't paste anything. The AI reads the task state. It checks the documentation. It understands exactly what "done" looks like. It doesn't rely on my faulty memory or my copy-pasting skills.

The best part? It closes the loop. When the AI solves a tricky problem, it extracts that knowledge and updates the project docs automatically.

No more lost context. No more "wait, let me give you the new file."
No more drowning in task management.

It just Knowns.

Video Demos

Workflow Demos

Real-world examples of using Claude Code with Knowns skills.

Task Workflow
~2 min
Claude CodeFull Workflow

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 →

Quick Installation

Get started with Knowns in seconds, then open the local UI and AI Chat.

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

Install with Homebrew
$ brew install knowns-dev/tap/knowns
Install with Shell
$ curl -fsSL https://knowns.sh/script/install | sh
Install with PowerShell
$ irm https://knowns.sh/script/install.ps1 | iex
Install with npm
$ npm install -g knowns
Install with npx
$ npx knowns
Quick Start
# Install with shell script
$ curl -fsSL https://knowns.sh/script/install | sh
# Or install with PowerShell
$ irm https://knowns.sh/script/install.ps1 | iex
# Initialize Knowns in your project
$ knowns init
# Or try without installing globally (npx)
$ npx knowns init
# Verify installation
$ knowns --version
# Upgrade later without reinstalling
$ knowns update
# Start the local UI + AI Chat (optional)
$ knowns browser --open

Keeping Skills & Agents Updated

After a new release, update your installation then run:

knowns sync

This keeps your skills and agents always up to date.

Platform-Specific Instructions

Open Source

Built by the Community

Knowns is open source and made better by contributors like you. Join us in building the future of knowledge management.

Report Issues

Found a bug? Open an issue to help us improve.

Submit PRs

Have a fix or feature? We welcome pull requests.

Improve Docs

Help make our documentation clearer and more helpful.

Our Contributors

Meet the Team

The people building Knowns to help developers manage knowledge better.

HN

Howz Nguyen

Founder & Lead Developer

HV

Harry Vu

Developer

Interested in contributing? Join us on GitHub

Join the Community

Connect with developers building with Knowns. Share tips, get help, and stay updated on new features.

Get Help

Ask questions and get answers from the community

Early Access

Be the first to try new features and updates

Connect

Meet other developers using Knowns

Free to join. No spam. Just developers helping developers.

Knowns

Ready to give your AI
persistent memory?

Stop repeating yourself. Start building with an AI that actually remembers your project context.

npm install -g knowns

Open source. Self-hosted. Built for developers.