sudoprivacy/sudocode

Rust-native CLI coding agent for hackers — terminal-native, pipe-composable, scrollback-safe. Built because Claude Code chose non-coders.

What Sudo Code is

Sudo Code は、ターミナル中心のパワーユーザー向けに設計された RustネイティブなコマンドラインAIコーディングアシスタント です。Anthropic、OpenAI、xAI、Gemini、または互換性のある任意のプロバイダーのLLM APIと通信できますが、特定のベンダーに縛られることはありません。APIキーは自分で提供し、オープンな ACP プロトコル経由で通信します。

このツールはシェル内でインラインで実行されます。画面を奪取したり、フルスクリーンTUIを開いたりすることはありません。Unixコマンドと同様にパイプで利用可能で、インタラクティブ（REPL）モードやワンショットモードで使用でき、エディタやブラウザ、その他のサービスが操作できるヘッドレスACPサーバーも提供できます。

Who it’s for

理想のユーザー	向いていないユーザー
ターミナル（tmux、ssh、VS Codeの統合ターミナルなど）でほとんど時間を過ごすエンジニアで、エージェントの動作を完全に可視化したい人（例：エージェントが操作する正確なソース行を読みたい人）。	ポイントアンドクリック型のコーディングアシスタントを探している初心者。
複数の並行するAI駆動タスクを管理し、スクリプトやパイプで制御したい人。	グラフィカルUIや「答えをただ教えてくれる」体験を求めるユーザー。
スタックを自社で管理し、バージョン固定、ゼロテレメトリのデフォルトを望むチーム。	ツールが内部の仕組みを隠してほしい人。

Core design principles (what it always does)

オープンソース、MITライセンス – コード全体が公開され、フォーク可能です。
モデル非依存 – 自分のAPIキーを提供するだけで、サポートされている任意のプロバイダーと動作します。
ヘッドレス最優先 – 同じバイナリがREPL、ワンショットCLI、ACPサーバーをすべてカバーします。
ローカル最優先＆テレメトリなし – 明示的に転送しない限り、プロンプトはあなたのマシン上に留まります。
インラインのみ – 出力はプレーンなANSIテキスト。スクロールバック、tmuxパネル、SSHセッションは一切変更されません。
安定した、バージョン固定のインターフェース – サイレントアップデートなし。Semverの保証があります。
すべてがファイル – 設定、セッションログ（JSONL）、プラグインはすべてファイルシステム上にあり、検査・awk処理・再実行が簡単です。

What it never does

隠れたプレミアム層や課金壁なし – バイナリが完全な製品です。
フルスクリーンTUIなし。ターミナル画面を奪取することはありません。
組み込みのマルチエージェントダッシュボードなし – 機械制御は外部ツール（例：SudoworkプラットフォームやHydraオーケストレーター）に任せます。
強制的な自動更新やテレメトリなし。
クローズソースのベンダーロックインなし。

How it works (high‑level architecture)

CLI / REPL – scode はインタラクティブに起動できるか、プロンプト文字列を指定して呼び出せます。プレーンテキスト、JSON、またはストリーミングSSE出力を生成します。
Runtime – Rustランタイムがセッション、権限、サンドボックス、設定を処理します。ファイルの場所を決定する FsBackend 実装を読み込みます：
- StdFsBackend – ローカルファイルシステム（スタンドアロンCLI）。
- NexusVfsFsBackend – gRPC経由のリモートVFS（エッジ/開発モード）。
- KernelFsBackend – インプロセスカーネルスタイルのシステムコール（マネージドエージェントモード）。
Tools & Plugins – bash、ファイルI/O、grep、ウェブ検索などの組み込みヘルパーに加え、カスタム「スキル」用のプラグインシステムがあります。
Model adapters – Anthropic、OpenAI、xAI、Gemini、またはモックバックエンドのAPIにACP呼び出しを変換する薄いラッパーです。
ACP server – scode acp serve でWebSocket/HTTP経由でエージェントを公開し、エディタやWeb UIが操作できるようにします。

Typical usage patterns

# インタラクティブREPLを開始（環境変数からトークンを取得）
export CLAUDE_CODE_OAUTH_TOKEN="sk-ant-…"
scode

# ワンショット、パイプ対応の使い方
scode "explain this function" | bat
scode "list failing tests" --output-format json | jq '.tests[]'

# 保存済みセッションを再開（セッションはJSONLファイルとして保存）
cat plan.md | scode --resume <session-id>

# エディタ統合用のヘッドレスサーバーとして実行
scode acp serve --port 8080

# すばやいヘルスチェック
scode doctor

Installation

ワンライナースクリプト – curl …/install.sh | sh でmacOSまたはLinux用のプリビルドバイナリをダウンロードし、SHA-256チェックサムを検証してシステムディレクトリ（またはsudoが利用できない場合は $HOME/.local/bin）にインストールします。Windowsユーザーはリリースページからzipを入手できます。
ソースから – git clone … && cd sudocode/rust && cargo build --release で ./target/release/scode を生成します。

Extensibility

Plugins/Skills – 指定されたディレクトリにコンパイル済みプラグインを配置し、CLIから呼び出せます。ドキュメントは docs/plugins.md にあります。
Permissions & sandbox – エージェントが読み取り・書き込み可能な範囲を細かく制御する方法は docs/permissions-and-sandbox.md に記載されています。
Authentication – OAuthトークン、APIキー、プロキシなど複数の認証モードについて docs/authentication.md に詳細が記載されています。

Roadmap & ecosystem

Sudo Codeは、他のSudoworkコンポーネント（Hydraオーケストレーター、VS Code拡張など）が共有メールボックスプリミティブ（Nexus VFS上の chat-with-me ストリーム）を介して制御できる単一エージェントユニットとして位置づけられています。将来の計画（sudo-code-roadmap.html を参照）には、Nexus VFSとのより深い統合、より豊かなプラグインAPI、1つのインタラクティブセッションから100以上のエージェントを管理するコピロットエージェントによるスケーリングが含まれます。

License: MIT – コントリビューターは自身の著作権を保持し、CLAは不要です。