Knowns

Knowns is a CLI-first knowledge management tool designed to give AI systems persistent, structured memory of your project context. It integrates directly into your development workflow, allowing you to capture, organize, and expose relevant information to LLMs without leaving the terminal. The primary purpose is to make AI interactions context-aware and grounded in the actual state, history, and decisions of your codebase and team.

The tool lets you define and manage “knowns” — discrete, versioned pieces of knowledge such as architecture notes, design decisions, API contracts, onboarding docs, or troubleshooting steps. These are stored in a repository-local knowledge base that can be searched, updated, and linked to specific files, directories, or commits. Knowns provides command-line utilities to sync this context with AI agents, ensuring prompts are enriched with accurate, up-to-date project information. Its design emphasizes transparency and control, so you can see exactly what context is shared and adjust it as your project evolves.