Knowns
AI-Powered Context Management

Know what yourteam knows.

CLI-first knowledge management that gives AI persistent memory of your project context. Document once, link everywhere.

The Problem

AI forgets your architecture between sessions. You repeat the same explanations.

The Solution

Reference with @doc/... and AI reads it automatically.

Get StartedGitHub Stars
knowns
$
Unlimited
Tasks & Docs
Built-in
Time Tracking
Native
AI Friendly
MIT
License

Everything you need to manage knowledge

A complete CLI toolkit for tasks, documentation, and time tracking. Built for developers, optimized for AI.

Task Management
Create tasks with acceptance criteria, track progress, and manage your backlog from the terminal.
Smart Documentation
Nested folders with Markdown support. Reference docs anywhere using @doc/patterns/auth syntax.
AI Context Linking
AI automatically reads referenced context via @doc/... and @task-... without manual copy-paste.
Time Tracking
Built-in timers with start/stop/pause. Generate reports by label, date range, or task.
Git-Friendly
All data in .knowns/ folder as Markdown files. Version control your knowledge base.
Web UI + CLI
Kanban board and document browser via 'knowns browser'. Dark mode included.

And much more... View all features on GitHub →

See it in Action

Interactive CLI demos showing real Knowns workflows. Click any tab to see different features.

claude
You

AI Workflow

See how Claude uses Knowns for context-aware development

Key Features:

  • AI reads your docs automatically
  • Tasks created with full context
  • Progress tracked as AI works
  • Works with Claude, Cursor, Copilot
knowns-demo ~ Task Management
$

Task Management

Create, track, and complete tasks from the terminal

Key Features:

  • Create tasks with acceptance criteria
  • Assign to team members with @username
  • Filter by status, priority, labels
knowns-demo ~ Documentation
$

Documentation

Create and manage docs with smart referencing

Key Features:

  • Markdown files with frontmatter
  • Reference docs with @doc/path syntax
  • Automatic AI context loading
knowns-demo ~ Time Tracking
$

Time Tracking

Track time spent on tasks with reports

Key Features:

  • Start/stop/pause timers
  • Generate reports by date range
  • Export to CSV for billing

Quick Reference

Common Commands
# Quick Reference
# Task Management
knowns task create "Title" -d "Description" --ac "Criterion"
knowns task list --plain
knowns task view <id> --plain
knowns task edit <id> -s in-progress -a @me
# Documentation
knowns doc create "Title" -d "Description" -t "tags"
knowns doc list --plain
knowns doc view "doc-name" --plain
# Time Tracking
knowns time start <id>
knowns time stop
knowns time report --from "2025-01-01" --to "2025-12-31"
# Search
knowns search "query" --plain

Quick Installation

Get started with Knowns in seconds

Install with npm
$ npm install -g knowns
Install with bun
$ bun install -g knowns
Install with yarn
$ yarn global add knowns
Install with pnpm
$ pnpm add -g knowns
Quick Start
# Initialize Knowns in your project
$ knowns init
# Start the browser UI (optional)
$ knowns browser

Platform-Specific Instructions

Need help? Read the documentation or open an issue

Meet the Team

The people building Knowns to help developers manage knowledge better.

HN

Howz Nguyen

Founder & Lead Developer

HV

Harry Vu

Developer

O

Olivia

Developer

Interested in contributing? Join us on GitHub