lessweb/deepcode-cli

Deep Code CLI – ターミナルベースのAIコーディングアシスタント

概要 – Node-JSコマンドラインツールで、プロジェクトフォルダから直接DeepSeek LLM（例：deepseek-flash、deepseek-v4‑pro）とチャットできます。DeepSeekの thinking mode とキャッシュ対応推論に最適化されており、OpenAI互換モデルでも動作します。

インストール

npm install -g @vegamo/deepcode-cli

グローバルインストール後、プロジェクトディレクトリで deepcode を実行してインタラクティブセッションを開始します。

設定 – ~/.deepcode/settings.json を作成します（VS Code拡張機能と共有）。例：

{
  "env": {
    "MODEL": "deepseek-flash",
    "BASE_URL": "https://api.deepseek.com",
    "API_KEY": "sk-…"
  },
  "thinkingEnabled": true,
  "reasoningEffort": "max"
}

このファイルは階層的なオーバーライド（プロジェクトレベル、ユーザーレベル、環境変数）をサポートしています。詳細は docs/configuration.md を参照してください。

主な機能

機能	説明
Agent Skills	./.deepcode/skills/、./.agents/skills/、~/.deepcode/skills/、または ~/.agents/skills/ からカスタム「スキル」（プラグイン）を読み込みます。スキルにより、追加のコマンドやツールでアシスタントを拡張できます。
DeepSeek固有の最適化	DeepSeekのKVキャッシュを使用してトークンコストを削減し、モデルの thinking mode を有効化し、推論の努力量（max、medium など）を制御できます。
スラッシュコマンドとホットキー	/new（新規チャット）、/resume（過去の会話の再開）、/model（モデルや思考設定の切り替え）、/mcp（接続済みMCPサービスの表示）、/undo などのクイックアクション。
マルチモーダル対応	選択したモデルが画像処理に対応している場合（deepseek-flash）、画像を貼り付け（Ctrl+V）たりファイルパスを指定したりすると、CLIがbase64またはDeepSeek Files API経由で送信します。
MCP統合	Model Context Protocolを通じて外部サービス（GitHub、ブラウザ、データベースなど）に接続し、mcpServers フィールドでサーバーを管理し、/mcp で呼び出します。
権限管理	シェル実行、ファイルI/O、ネットワークアクセスに対するきめ細かなポリシー設定。アクションごとに allow、ask、deny を設定可能です。
タスク完了通知	タスク終了後にユーザー指定のスクリプト（Slack webhookなど）を実行します（notify フィールドで設定）。
クライアント間共有	VS Code拡張機能と同じ settings.json を使用するため、ターミナルとエディタをシームレスに切り替えられます。

一般的なワークフロー

1. deepcode → REPLを開始。
2. プロンプトを入力（コードの質問、バグの説明、設計依頼）。
3. /model を使用してモデルを選択または thinking mode を切り替え。
4. / メニューまたはスラッシュコマンドでスキルを呼び出し。
5. 権限設定に従って、生成されたファイルやシェルアクションを承認または拒否。
6. 完了 – オプションの通知スクリプトが自動実行されます。

ツールの拡張 – JavaScript/TypeScriptモジュールを4つのスキルディレクトリのいずれかに配置します。CLIは表に示された順序でスキャンするため、コアを再ビルドすることなくプロジェクト固有またはユーザー全体の拡張が可能です。

関連プロジェクト – 対応するVS Code拡張機能 (vegamo.deepcode-vscode) は同じ設定ファイルを共有しており、ベンチマークリポジトリ (deepcode-qrcode-benchmark) は、実際のPythonタスクにおけるDeep Code + DeepSeekのパフォーマンス上の利点を示しています。

開発と貢献

git clone https://github.com/lessweb/deepcode-cli.git
cd deepcode-cli
npm install
npm test          # テストの実行
npm run build      # lint、型チェック、コンパイル
npm link           # ローカルテスト用にグローバルリンク

PRを提出する前に、npm run check（型チェック + lint）と npm run format を実行してください。

ライセンス – MIT。

---

すべての詳細はリポジトリのREADMEから直接引用しています。