Documentation

Public documentation for Knowns CLI.

Source file6acb7f3Updated Jul 11, 2026, 3:47 AM

Knowns Documentation

Knowns is a project context layer for software teams and AI agents. It gives a repository one shared place for tasks, docs, memory, templates, semantic search, and AI integrations.

Use these docs if you want to:

  • set up Knowns in an existing repository
  • keep project work, decisions, and docs readable by both humans and AI
  • connect assistants through MCP, skills, or lightweight shim files
  • use the Web UI for boards, docs, graph views, and chat workflows

Core ideas

  • Task: planned work with status, acceptance criteria, notes, and links to context.
  • Doc: durable project knowledge such as architecture, specs, decisions, or onboarding material.
  • Memory: short reusable context that should be recalled later, such as conventions or preferences.
  • Template: reusable project scaffolding for repeated code or document patterns.
  • Search / retrieval: local context lookup that connects tasks, docs, memory, and code references.
  • MCP and skills: AI integration surfaces. MCP exposes structured tools; skills are agent-side workflow commands such as /kn-* in Claude or $kn-* in Codex.
  1. Installation
  2. Quick start
  3. First project
  4. Why Knowns exists
  5. User guide
  6. Task Management
  7. AI Agent Guide
  8. AI Workflow

Which page should I read first?

Structure

  • getting-started/
    • installation and first-run docs
  • guides/
    • practical usage guides
  • reference/
    • command and config reference
  • integrations/
    • platform, MCP, skills, templates, sync, and compatibility
  • contributing/
    • contributor-oriented notes

Index

Getting started

Guides

Reference

Integrations

Contributing