Introduction
Getting started with Knowns CLI - the knowledge management tool for developers
Introduction
Knowns is a CLI-first knowledge and workflow layer that gives AI persistent memory of your project context. Document once, link everywhere.
v0.22 brings LSP-based code intelligence, knowns setup for AI platform integrations, granular git tracking toggles, and native Go ONNX embedding (no sidecar needed).
Core Capabilities
Project Memory
2-layer memory (project, global) keeps decisions and patterns across sessions.
Task Management
Tasks with acceptance criteria, plans, status tracking, and time management.
Structured Docs
Nested markdown folders with cross-references and semantic search.
Semantic Search
AI-powered search using native ONNX embedding. Find by meaning, not keywords.
Code Intelligence
LSP-based code navigation: symbols, references, definitions, rename across Go, TS, JS, Python, Rust, and more.
MCP Integration
Full Model Context Protocol server for Claude, Cursor, Kiro & more.
How It Works
Before & After
Latest Releases
See the Changelog for release details.
How To Use These Docs
If you are new to Knowns, read the docs in this order:
- Installation — Get Knowns running
- Task Management — Create and manage tasks
- Workflow — Choose the right workflow
- CLI Reference — Full command reference
- Feature-specific pages: MCP, Memory, Code Intelligence, Web UI
Prerequisites
Knowns supports multiple install paths. Only the npm-based path requires Node.js 20+. See the Installation Guide for platform-specific instructions.
Quick Start
# Install
curl -fsSL https://knowns.sh/script/install | sh
# Initialize in your project
cd your-project
knowns init
# Create your first task
knowns task create "Setup project" -d "Initial setup" --ac "Dependencies installed"
# Open local UI + AI Chat
knowns browser --open
# (Optional) Auto-setup MCP for AI assistants
knowns mcp setup
Core Concepts
Tasks
Tasks are the primary work items in Knowns. Each task has:
- Title: Clear summary of what needs to be done
- Description: Context and requirements
- Acceptance Criteria: Testable outcomes
- Status: todo, in-progress, in-review, blocked, on-hold, done, urgent
Documentation
Documentation lives in .knowns/docs/ as Markdown files with frontmatter. Reference docs anywhere using @doc/path syntax.
Memory
Two-layer memory system for persistent AI context:
- Project memory: Repo-specific patterns, decisions, conventions
- Global memory: Cross-project preferences and workflow rules
Templates
Code generation with Handlebars (.hbs) templates. Each template can link to documentation for context-aware generation.
Next Steps
- Installation Guide - Detailed setup instructions
- Task Management - Learn about task workflows
- Memory System - Persistent context for AI agents
- Code Intelligence - Index and explore symbols, deps, and code graph
- Semantic Search - AI-powered search with native ONNX
- CLI Reference - Complete command reference
Giới thiệu
Knowns là CLI-first knowledge và workflow layer cho AI persistent memory về project context. Document một lần, link mọi nơi.
v0.22 mang đến LSP-based code intelligence, knowns setup cho AI platform integrations, granular git tracking toggles, và native Go ONNX embedding (không cần sidecar).
Khả năng chính
Project Memory
Memory 2 layer (project, global) giữ decisions và patterns across sessions.
Task Management
Tasks có acceptance criteria, plans, status tracking, và time management.
Structured Docs
Nested markdown folders có cross-references và semantic search.
Semantic Search
Tìm kiếm AI-powered bằng native ONNX embedding. Tìm theo ý nghĩa, không chỉ keyword.
Code Intelligence
LSP-based code navigation: symbols, references, definitions, rename cho Go, TS, JS, Python, Rust, và nhiều hơn.
MCP Integration
Full Model Context Protocol server cho Claude, Cursor, Kiro & nhiều hơn.
Cách hoạt động
Trước & Sau
Bản phát hành mới nhất
Xem Changelog để biết chi tiết các bản phát hành.
Cách sử dụng tài liệu này
Nếu bạn mới dùng Knowns, đọc theo thứ tự:
- Cài đặt — Cài Knowns
- Task Management — Tạo và quản lý tasks
- Workflow — Chọn workflow phù hợp
- CLI Reference — Tham khảo lệnh đầy đủ
- Trang tính năng: MCP, Memory, Code Intelligence, Web UI
Yêu cầu
Knowns hỗ trợ nhiều cách cài đặt. Chỉ cài qua npm mới cần Node.js 20+. Xem Hướng dẫn cài đặt cho hướng dẫn theo nền tảng.
Bắt đầu nhanh
# Cài đặt
curl -fsSL https://knowns.sh/script/install | sh
# Khởi tạo trong project
cd your-project
knowns init
# Tạo task đầu tiên
knowns task create "Setup project" -d "Initial setup" --ac "Dependencies installed"
# Mở local UI + AI Chat
knowns browser --open
# (Tùy chọn) Auto-setup MCP cho AI assistants
knowns mcp setup
Khái niệm cốt lõi
Tasks
Task là đơn vị công việc chính trong Knowns. Mỗi task có:
- Title: Tóm tắt rõ ràng việc cần làm
- Description: Context và requirements
- Acceptance Criteria: Kết quả có thể kiểm tra
- Status: todo, in-progress, in-review, blocked, on-hold, done, urgent
Documentation
Documentation nằm trong .knowns/docs/ dạng Markdown files với frontmatter. Reference docs bằng cú pháp @doc/path.
Memory
Hệ thống memory 2 layer cho persistent AI context:
- Project memory: Patterns, decisions, conventions riêng repo
- Global memory: Preferences và workflow rules cross-project
Templates
Code generation bằng Handlebars (.hbs) templates. Mỗi template có thể link tới documentation cho context-aware generation.
Bước tiếp theo
- Hướng dẫn cài đặt - Hướng dẫn setup chi tiết
- Task Management - Tìm hiểu về task workflows
- Memory System - Persistent context cho AI agents
- Code Intelligence - Index và explore symbols, deps, code graph
- Semantic Search - Tìm kiếm AI với native ONNX
- CLI Reference - Tham khảo lệnh đầy đủ