AI が動かす前提で CLI を設計する

Mon, 15 Jun 2026 15:00:00 +0900

シリーズ・第 5 回（最終回） — 「個人で出版ツールを作って配るまで」（全 5 回）。前回はbrew と scoop で配る話でした。一覧はシリーズの記事一覧から。今回のテーマは「AI が動かす前提の CLI 設計」です。

crofty は、端末から打つ素朴な CLI です。ただ、設計の前提が少しだけ変わっています。

「人が crofty を入れて最初の設定をしたら、あとはその人の AI（エージェント）が回す」。そういう使われ方を想定しています。人が毎回コマンドを覚えて打つのではなく、人の代わりにエージェントが crofty を動かす。そのときに困らない作りにしておく、ということです。

操作する相手に AI を含めると、CLI の設計はどう変わるか。シリーズ最終回は、その話です。

クリックでなく、出力を窓口にする

人とエージェントでは、できることが違います。人は画面をクリックでき、ドキュメントを読めます。エージェントはクリックできませんが、コマンドを実行して、その出力を読めます。

この違いから、設計の重心が「画面」から「出力テキスト」に移ります。だから crofty は、GUI や管理画面を作りません。代わりに、コマンドの出力を、人にもエージェントにも読める窓口にすることに力を入れています。具体的には、次の 3 つです。

① 何ができるかは、聞けば分かる

機能をドキュメントの奥に埋めず、ツール自身に聞けるようにします。

エージェントが最初に知りたいのは「どんなコマンドがあって、どう使うのか」です。crofty agent は、その全体像 ― コマンドと引数、使う順番、状態を読むための口 ― を一度にまとめて返します。AI にまず読ませる一枚で、これを実行すれば、あとは自分で動き出せます。

そのうえで、目的別の窓口もあります。crofty features は「何ができて、どう有効にするか」を返します。

$ crofty features
crofty features — what you can do, and how to turn each thing on.

Out of the box (works in a fresh project):
    rss        an Atom/RSS feed and a 'Follow by RSS' link
               → automatic — nothing to set
    share      reader share buttons, and `crofty share` …
               → automatic on posts; `crofty share <path>` for authors

Restyle (owned, contract-safe):
    looks      ready-made colour/type presets (quiet-paper, …)
               → crofty theme set <name>

各行に「何ができるか」と「どう有効にするか」がセットで出ます。crofty config を打てば、「今どうなっているか」も同じように返ります。どれも、人が読んでも AI が読んでも、ドキュメントを探さずに動き出すための窓口です。

エージェント on nsys.dev 技術ブログ

AI が動かす前提で CLI を設計する

クリックでなく、出力を窓口にする

① 何ができるかは、聞けば分かる