HN 日本語サマリー

← 一覧へ戻る
プログラミング

Show HN: Aict – AIエージェント向けに構築された、XML/JSONを出力するUnixコアユーティリティ

Show HN: Aict – Unix coreutils that output XML/JSON, built for AI agents (github.com)

8 pointsby ronak_parmar1 コメント

要約

aictは、33のUnixコアユーティリティを再実装し、AIエージェントが直接読み取れるXMLまたはJSON形式で構造化されたデータを出力するツールです。これにより、AIエージェントは人間が読めるプレーンテキストを解析する際のトークン消費や処理の脆弱性を回避できます。aictは、ファイルサイズ、言語、MIMEタイプなどの詳細情報を付与し、AIのタスク実行効率と精度を向上させます。

全文翻訳

[画像: aict]

AIエージェント向けに構築された、XML/JSONを出力するUnix coreutils。人間向けではない。

[画像: CI] [画像: Go 1.25] [画像: Release] [画像: Go Report Card] [画像: License: MIT] [画像: Stars]

インストール ・ クイックスタート ・ 全ツール ・ MCPサーバー ・ Claude Code連携 ・ トークンコスト ・ ベンチマーク ・ コントリビューティング

[画像: aict デモ: 従来のls出力とaictの構造化された出力]


問題点

AIエージェントはls、grep、catを実行しても、人間が読めるプレーンテキストしか得られません。その後、トークンを消費して列の位置を解析したり、フィールド幅を推測したり、一貫性のないフォーマットを処理したりします。これは脆弱で無駄が多いです。

-rw-r--r-- 1 user staff  2048 Apr  6 10:00 main.go        ← サイズの列はどれ?
-rw-r--r-- 1 user staff  1024 Apr  6 10:00 utils.go       ← 言語は何?
drwxr-xr-x 5 user staff   160 Apr  6 10:00 internal       ← これはディレクトリ?

解決策

aictは34のUnixツールを再実装し、エージェントが直接読み取れる構造化された出力を提供します。解析は不要です。

$ aict ls src/
<ls timestamp="1746123456" total_entries="3">
  <file name="main.go" path="src/main.go" absolute="/project/src/main.go"
        size_bytes="2048" size_human="2.0K" language="go" mime="text/x-go"
        binary="false" executable="false" modified="1746120000" modified_ago_s="3456"/>
  <file name="utils.go" path="src/utils.go" absolute="/project/src/utils.go"
        size_bytes="1024" size_human="1.0K" language="go" mime="text/x-go"
        binary="false" executable="false" modified="1746120000" modified_ago_s="3456"/>
  <directory name="internal" path="src/internal" modified="1746120000"/>
</ls>

すべてのフィールドにラベルが付いています。パスは常に絶対パスです。タイムスタンプはUnixエポック秒です。言語とMIMEタイプは自動検出されます。解析は一切不要です。


インストール

Homebrew (macOS)
brew tap synseqack/aict
brew install aict

これにより、aictとbashおよびzsh用のシェル補完がインストールされます。MCPサーバーも組み込まれています: aict mcp。

Go Install
go install github.com/synseqack/aict@latest
ソースからビルド
git clone https://github.com/synseqack/aict
cd aict
go build -o aict .

インストール確認: aict --help で利用可能なすべてのツールが表示されるはずです。


クイックスタート

# デフォルト: XML出力 (AIエージェントに最適)
aict ls src/
aict grep "func" . -r
aict cat main.go
aict diff old.go new.go

# JSON出力
aict ls src/ --json

# プレーンテキスト (元のUnixツールと同じ)
aict ls src/ --plain

# XMLはデフォルトです。これはシェルエイリアスで --json/--plain を上書きする場合にのみ必要です
export AICT_XML=1

ツール

6つのカテゴリにわたる34のツール。すべてのツールは --xml (デフォルト)、--json、--plain をサポートします。コンパクトモード (デフォルト) はトークンを節約するために短い属性名を使用します。冗長な出力には --no-compact を、マッピングを確認するには --dict を使用してください。

カテゴリツール
ファイル検査cat head tail file stat wc
検索と比較ls find grep diff
パスユーティリティrealpath basename dirname pwd
テキスト処理sort uniq cut tr sed awk
データとアーカイブjq tar
システムと環境env system ps df du checksums md5sum sha1sum sha256sum

追加: git (status, diff, log, ls-files, blame) ・ completions (bash/zsh/fish) ・ doctor (自己診断)


出力フォーマット

すべてのツールは同じ規約に従います:

フィールドコンパクト (デフォルト)冗長 (--no-compact)
パスp, apath, absolute
タイムスタンプt (エポック整数) + ma (_ago_s)timestamp + modified_ago_s
サイズs (バイト) + sh (size_human)size_bytes + size_human
ブール値1 / 0`