What your AI shouldhave knowns.

Give your AI persistent memory of your project context with a native Go runtime 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?
134
GitHub Stars
1.6k+
Downloads/mo
21
Forks
MIT
License

Built for faster, project-aware AI work

Native Go performance, structured project memory, and built-in AI Chat on OpenCode.

Native Go performance
Knowns now runs as a native Go binary for faster startup, lower overhead, and a smoother local developer experience.
Spec-Driven Development
Write specs before code with /kn:spec. Tasks auto-link to specs, ACs sync automatically. Verify coverage with /kn:verify.
AI Chat with OpenCode
Built-in AI Chat runs on OpenCode, so project-aware conversations live beside your tasks, docs, and workflows.
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.
Automatic AI context
Assistants auto-resolve @doc/@task/@template refs (CLI or MCP) so prompts stay short—no manual copy-paste.
Import & Sync
Import docs and templates from Git repos, npm packages, or local folders. Keep them synced automatically.
Semantic Search
AI-powered search using vector embeddings. Find tasks and docs by meaning, not just keywords. Local models for privacy.
Time tracking built-in
Start/stop/pause timers and generate reports by label, date range, or task without extra tools.
Dashboard, Web UI, and Chat
Refreshed local interface with faster responsiveness, Kanban, docs browser, and AI chat in one place.
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
# 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.