Knowns CLI
Knowns · 生産性向上 · 学習
Knowns CLI は、AIコーディングアシスタントにプロジェクトの永続的な記憶層を与えるローカルファーストのコマンドラインツールだ。毎回のチャットで同じコンテキストを繰り返す代わりに、リポジトリ内で `knowns init` を一度実行する。以降、タスク、ドキュメント、決定事項、エージェントのコンテキストはターミナルとローカル WebUI の間でつながったままになる。Claude Code、Codex、GitHub Actions といったツールと並んで動く。ホスト型のアカウントは不要だ。
Knowns CLI について
Knowns CLI とは
Knowns CLI が扱うのは、AIコーディングアシスタントを使う人なら誰でもすぐ突き当たる問題だ。アシスタントは忘れる。新しいセッションは毎回ゼロから始まるので、アーキテクチャをまた説明し、同じファイルをまた貼り付け、モデルが点と点をつないでくれることを願うことになる。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 を開く。
AIツール情報
Knowns CLIの料金、対応プラットフォーム、性能を簡単に確認できます。
こんな人におすすめ
このツールが最も力を発揮するユーザー、タスク、シーン。
ユーザー
- AIコーディングアシスタントを使う個人開発者：ターミナル操作に抵抗がなければ、Knowns は Claude Code や Codex にセッションをまたぐ信頼できるプロジェクトコンテキストを与える。
- 小規模な開発チーム：共有されたタスク、ドキュメント、引用付きの決定事項が、繰り返しのオンボーディングのやり取りを削る。全員が CLI をローカルにインストールする必要がある。
タスク
- プロジェクトコンテキストの復元：`knowns retrieve` が引用付きのコンテキストパックを組み立てるので、エージェントは推測ではなく実在の出典から始められる。
- 計画済み作業の追跡：タスクは優先度と関連を伴うので、やるべきことは背後のドキュメントや決定事項とつながったままになる。
- ドキュメントの健全性監査：`knowns doctor` が、セッションを脱線させる前に壊れた参照と古いガイドを指摘する。
シーン
- 長く続くリポジトリで新しいセッションを始める：記憶層があるので、毎回同じファイルを貼り直さずに済む。
- 複数プロジェクトを行き来する：各リポジトリが固有の記憶を持つので、コンテキストがコードベース間で混ざらない。
- CI でエージェントのワークフローを動かす：GitHub Actions はローカル CLI が書くのと同じプロジェクト状態を読める。
主な機能
永続的なプロジェクト記憶
中心となる考えは単純だ。コマンドは出力を印字するだけでなく、構造化されたコンテキストを残す。リポジトリを一度初期化すれば、その後もタスク、ドキュメント、決定事項、エージェントのコンテキストはつながったままになる。これは、質問に答えるだけのツールと、次のために答えを覚えておくツールの違いだ。
引用付きコンテキスト検索
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の代替ツール
Udon
Udon · コーディング · 生産性向上Udon は Apple Silicon の Mac を Mac 家庭用サーバーに変えるソフトだ。ブラウザからコンテナとファイル共有を操作でき、AI システム管理者も任意で使える。
offstage
offstage cloud · コーディング · 生産性向上offstage は AI エージェントと CI ジョブに本物の Mac を渡す。Apple Silicon 上の macOS 27 アカウントを API で操作し、秒単位で課金される。
BotBus
Chengdu Tuyang Tusen Technology Co., Ltd. · コーディング · 生産性向上BotBusを使えば、スマホからAIコーディングエージェントを操作できる。席を外したままコマンドを承認し、タスクを始め、結果を確認できる。