Knowns CLI
Knowns · 생산성 · 학습
Knowns CLI는 AI 코딩 어시스턴트에 프로젝트용 영구 메모리 계층을 제공하는 로컬 우선 명령줄 도구다. 매 대화마다 같은 콘텍스트를 반복하는 대신, 저장소 안에서 `knowns init`을 한 번 실행한다. 그 뒤로는 작업, 문서, 결정, 에이전트 콘텍스트가 터미널과 로컬 WebUI 사이에서 연결된 상태로 유지된다. Claude Code, Codex, GitHub Actions 같은 도구와 나란히 동작한다. 호스팅 계정은 필요 없다.
Knowns CLI 소개
Knowns CLI란 무엇인가
Knowns CLI가 다루는 문제는 AI 코딩 어시스턴트를 쓰는 사람이라면 누구나 금방 마주친다. 어시스턴트는 잊어버린다. 새 세션은 매번 0에서 시작하므로, 아키텍처를 다시 설명하고, 같은 파일을 다시 붙여 넣고, 모델이 점과 점을 이어 주길 바라게 된다. Knowns는 그 콘텍스트를 대화 창 밖으로 꺼내 저장소 자체에 둔다. 사람과 에이전트 모두 나중에 확인할 수 있는 곳이다.
이 도구는 구조화된 상태를 남기는 작은 명령 집합을 중심으로 짜여 있다. knowns init은 저장소의 메모리 계층을 만든다. knowns task create는 작업 한 덩어리를 우선순위와 관계, 출처 콘텍스트를 함께 지닌 주소 지정 가능한 객체로 바꾼다. knowns retrieve는 근거 없는 추측 대신 인용이 붙은 순위화된 콘텍스트 팩을 돌려준다. knowns doctor는 작업을 시작하기 전에 끊긴 참조와 낡은 안내를 드러낸다.
미리 알아 둘 제약이 두 가지 있다. Knowns는 개발자 도구이지 소비자용 앱이 아니다. 터미널이 익숙하지 않고 코딩 에이전트도 쓰지 않는다면 여기서 얻을 게 거의 없다. 시맨틱 검색에는 Ollama나 OpenAI 호환 엔드포인트 같은 임베딩 공급자도 필요하다. 없으면 검색은 키워드 결과로 떨어진다. 검색 품질의 실질적 하락이다. 그래도 도구 자체는 동작한다.
시작하기
- Homebrew, npm, 셸 스크립트, PowerShell, npx 중 하나로 CLI를 설치하고
knowns --version으로 확인한다. - Knowns가 관리하기를 원하는 저장소로 이동해
knowns init을 실행하여 로컬 메모리 계층과 가벼운 안내 파일을 만든다. knowns task create "Setup project" -d "Initialize project with Knowns"로 첫 작업을,knowns doc create로 첫 문서를 만든다.knowns search와knowns validate를 실행해 검색이 콘텍스트를 찾는지, 프로젝트 구조가 온전한지 확인한다.knowns setup claude --global또는knowns setup codex --global로 AI 플랫폼을 연결하고,knowns browser --open으로 WebUI를 연다.
제품 정보
Knowns CLI의 요금, 지원 플랫폼, 성능을 한눈에 확인해 보세요.
추천 대상
이 도구가 가장 잘 맞는 사용자, 작업, 상황입니다.
사용자
- AI 코딩 어시스턴트를 쓰는 개인 개발자
- 소규모 엔지니어링 팀
작업
- 프로젝트 콘텍스트 복원
- 계획된 작업 추적
- 문서 건강 점검
활용 상황
- 오래 운영된 저장소에서 새 세션 시작
- 여러 프로젝트를 오가기
- CI에서 에이전트 워크플로 실행
주요 기능
영구적인 프로젝트 메모리
핵심 발상은 단순하다. 명령은 출력만 찍는 게 아니라 구조화된 콘텍스트를 남긴다. 저장소를 한 번 초기화하면, 이후로도 작업, 문서, 결정, 에이전트 콘텍스트가 연결된 상태로 유지된다. 질문에 답하는 도구와, 다음을 위해 그 답을 기억하는 도구의 차이다.
인용된 콘텍스트 검색
knowns retrieve는 인용을 붙인 순위화된 콘텍스트 팩을 돌려준다. 각 인용에는 유형과 경로 또는 ID가 포함된다. 먼저 검색해 후보 출처를 찾고, 워크플로가 더 깊이를 필요로 할 때만 --expand-references로 관계를 확장할 수 있다. 키워드, 시맨틱, 하이브리드 모드를 모두 쓸 수 있다.
프로젝트 상태로서의 작업 관리
CLI로 만든 작업은 단순한 목록 항목이 아니라 주소 지정 가능한 객체가 된다. 우선순위, 관계, 출처 콘텍스트가 각 작업과 함께 다니므로 knowns task TASK-042 --plain은 검토 가능한 형태로 돌아온다. 바로 이 구조 덕분에 코딩 에이전트가 기존 작업을 이어받아, 그것을 형성한 결정, 문서, 관련 작업을 곧바로 이해한다. 그 배경을 대화에 붙여 넣을 필요가 없다.
반복되는 콘텍스트를 대체하는 문서
문서는 프로젝트의 오래가는 지식을 담는다. 매번 같은 아키텍처를 AI 대화에서 다시 설명하는 것보다 낫다. knowns doc create는 CLI와 WebUI가 읽는 것과 같은 저장소에 그것들을 더하므로, 진실은 한 가지 버전만 존재한다.
로컬 WebUI
knowns browser --open은 CLI의 프로젝트 상태를 그대로 비추는 로컬 WebUI를 연다. 작업, 문서, 그래프 뷰, 설정을 포함한다. 머신을 벗어나거나 호스팅 서비스에 로그인하지 않고도 시각적 개요를 얻는다.
코딩 에이전트용 플랫폼 설정
knowns setup <target> --global은 Claude Code, Codex, OpenCode, Kiro, Cursor, Gemini CLI, GitHub Copilot, 그리고 일반 에이전트 대상에 맞는 MCP 연동 설정, 스킬, 런타임 훅을 생성한다. Claude는 /kn- 스킬 명령을 쓴다. Codex는 $kn- 명령을 쓴다.
knowns doctor로 하는 상태 점검
낡은 안내와 끊긴 참조는 최악의 순간에 알게 되는 종류의 문제다. 대개 작업 도중, 에이전트가 코드와 더 이상 맞지 않는 문서를 자신 있게 따라갈 때 발견된다. knowns doctor는 작업이 시작되기 전에 그것들을 드러내므로, 메모리 계층을 시간이 지나도 믿을 만하게 유지한다.
유연한 설치
단일 바이너리가 모든 플랫폼에 배포되고, 동봉된 공유 라이브러리도 없어서 CLI는 macOS, Linux, Windows에서 똑같이 동작한다. Homebrew, npm, 셸, PowerShell, npx를 모두 지원한다. npx를 쓰면 전역 설치 없이 시험해 볼 수 있다.
장단점
장점
- 호스팅 계정이 없는 로컬 우선 설계라서 프로젝트 메모리가 내 머신에 남는다.
- 인용된 검색은 에이전트에게 자신감 넘치는 추측이 아니라 근거 있는 출처를 준다.
- Claude Code와 Codex부터 Cursor, GitHub Copilot까지 플랫폼 지원이 탄탄하다.
- 기존 저장소에서 동작하므로 마이그레이션 단계가 없다.
단점
- 시맨틱 검색에는 별도의 임베딩 공급자가 필요하고, 없으면 품질이 키워드 검색으로 떨어진다.
- 호스팅 계정이 없으므로 기본적으로 콘텍스트가 머신 간에 동기화되지 않는다.
- CLI 도구가 처음이라면 학습 부담이 작지 않다. 가치는 명령을 꾸준히 쓸 때 나오기 때문이다.
자주 묻는 질문
AI 코딩 어시스턴트에 영구적인 프로젝트 메모리를 준다. 저장소를 한 번 초기화하면 작업, 문서, 결정, 에이전트 콘텍스트가 연결된 상태로 유지된다. 어시스턴트는 세션 사이에서 흐름을 놓치지 않는다.
관련 콘텐츠
Knowns CLI와 관련된 도구, 스킬, 아티클을 살펴보세요.
Knowns CLI 대안
Base Code
Base44 (Wix) · 코딩 · 생산성Base Code는 Base44가 만든 공유 클라우드 개발 환경이다. 팀은 기존 GitHub 저장소에 대한 변경을 채팅으로 설명하고, 미리보기로 확인한 뒤 풀 리퀘스트로 돌려보낸다.
Knocket
Knocket (Tencent RTC team) · 생산성 · 비즈니스 · 챗봇Knocket은 무료 라이브 채팅과 연락처 페이지 도구다. 방문자는 웹사이트, 앱, 공유 링크에서 메시지를 보내고, 운영자는 텔레그램이나 하나의 받은편지함에서 답한다.
FloorGen
Vinit Kumar (FloorGen) · 생산성 · 중국 AIFloorGen은 브라우저에서 도는 평면도 제작 도구다. 문장이나 스케치를 편집 가능한 2D 평면도와 3D 둘러보기로 바꾸고, PDF, DXF, 영상으로 내보낸다. 계정 없이도 그릴 수 있다.