# Knowns CLI — turning project knowledge into real context for AI

AI can write code very quickly. But if it doesn't understand your project, it can easily create misdirected solutions.

The problem is not that AI lacks capability.

The problem is that AI lacks context.

Every time you start a new session, you have to:

- re-explain the system architecture

- resend relevant documentation

- remind of team conventions

- describe the task you are working on

- provide additional context for AI to understand the issue correctly

This process is both time-consuming and disrupts the workflow. Just missing a piece of context can significantly reduce the quality of AI’s output.

Knowns CLI was created to address this very issue.

Knowns is an open-source platform that helps you organize tasks, documentation, and project knowledge in a way that AI can read, understand, and directly utilize.

Instead of copy-pasting context repeatedly, you just need to reference:

@doc/architecture

@task/auth-flow

AI will access the correct documentation, understand the right context, and assist you more accurately with each task.

Why is Knowns important?

As AI becomes part of the software development process, project knowledge can no longer remain scattered in many places or exist in hard-to-access forms.

For AI to work effectively, the project needs a structured knowledge layer — where docs, tasks, and specs are clearly organized, interconnected, and ready for both humans and AI to use.

Knowns is that knowledge layer.

Key Features

Knowledge layer for AI

Knowns turns documentation and tasks into a structured source of context, so that AI can read, reference, and use it directly during the workflow.

Tasks, specs, and docs in one system

All important project information is connected, ensuring that the team and AI are always working from the same source of truth.

CLI-first for developers

Create tasks, read docs, and query knowledge right in the terminal without leaving your familiar workspace.

Intuitive WebUI

Easily view project overviews, edit lengthy documents, and manage tasks through a clear and user-friendly web interface.

Realtime synchronization

All changes between the CLI and WebUI are updated instantly, keeping the workflow seamless.

Open source and self-hosted

Data is stored in Markdown, Git-friendly, platform-agnostic, and can be fully self-hosted.

What can Knowns help you achieve?

- Reduce the need to repeat context for AI in each session

- Help AI understand the architecture and conventions of the project

- Increase accuracy when AI assists with coding and technical decision-making

- Organize project knowledge in a clear, structured, and easily accessible manner

- Integrate docs, tasks, and AI into one modern workflow

In conclusion

Knowns is not just a task management or documentation tool.

It is a knowledge layer for development in the age of AI — where project knowledge is organized properly for AI to truly understand, collaborate, and create value in your workflow.

Website: https://knowns.sh

GitHub: https://github.com/knowns-dev/knowns