CLI

AicippY CLI のオプションとコマンド。

AicippY CLI は、引数なしで実行すると、デフォルトで TUI を開始します。

aicippy-code

ただし、このページに記載されているようにコマンドも受け入れます。これにより、AicippY をプログラム的に操作できるようになります。

aicippy-code run "Explain how closures work in JavaScript"

tui

AicippY ターミナルユーザーインターフェイスを開始します。

aicippy-code [project]

フラグ

フラグ	ショート	説明
`--continue`	`-c`	最後のセッションを続行
`--session`		続行時にセッションをフォーク (`-s` または `--fork` と併用)
`--continue`	`--session`	続行するセッション ID
`--prompt`		使用のプロンプト
`--model`	`-m`	プロバイダー/モデルの形式で使用するモデル
`--agent`		使用するエージェント
`--port`		リッスンするポート
`--hostname`		リッスンするホスト名

コマンド

AicippY CLI には次のコマンドもあります。

agent

AicippY のエージェントを管理します。

aicippy-code agent [command]

attach

serve または web コマンドを使用して起動された、すでに実行中の AicippY バックエンドサーバーにターミナルを接続します。

aicippy-code attach [url]

これにより、リモート AicippY バックエンドで TUI を使用できるようになります。例えば：

# Start the backend server for web/mobile access
aicippy-code web --port 4096 --hostname 0.0.0.0

# In another terminal, attach the TUI to the running backend
aicippy-code attach http://10.20.30.40:4096

フラグ

フラグ	ショート	説明
`--dir`		TUI を開始する作業ディレクトリ
`--continue`	`-c`	最後のセッションを続行
`--session`	`-s`	続行するセッション ID
`--fork`		続行時にセッションをフォーク（`--continue` または `--session` と使用）
`--password`	`-p`	Basic 認証パスワード（デフォルトは `AICIPPY_CODE_SERVER_PASSWORD`）
`--username`	`-u`	Basic 認証ユーザー名（デフォルトは `AICIPPY_CODE_SERVER_USERNAME` または `aicippy-code`）

create

カスタム構成で新しいエージェントを作成します。

aicippy-code agent create

このコマンドは、カスタムシステムプロンプトとツール構成を使用して新しいエージェントを作成する手順を示します。

list

利用可能なエージェントをすべてリストします。

aicippy-code agent list

auth

プロバイダーの資格情報とログインを管理するコマンド。

aicippy-code auth [command]

AicippY は AicippY Models のプロバイダーリストを利用しているため、aicippy-code auth login を使用して、使用したいプロバイダーの API キーを構成できます。これは ~/.local/share/aicippy-code/auth.json に保存されます。

aicippy-code auth login

AicippY が起動すると、認証情報ファイルからプロバイダーがロードされます。また、環境またはプロジェクト内の .env ファイルで定義されたキーがあるかどうかも確認します。

list

認証情報ファイルに保存されているすべての認証されたプロバイダーをリストします。

aicippy-code auth list

またはショートバージョン。

aicippy-code auth ls

logout

資格情報ファイルからプロバイダーをクリアすることで、プロバイダーからログアウトします。

aicippy-code auth logout

github

リポジトリ自動化のための GitHub エージェントを管理します。

aicippy-code github [command]

install

GitHub エージェントをリポジトリにインストールします。

aicippy-code github install

これにより、必要な GitHub Actions ワークフローが設定され、構成プロセスがガイドされます。詳細はこちら。

run

GitHub エージェントを実行します。これは通常、GitHub Actions で使用されます。

aicippy-code github run

フラグ

フラグ	説明
`--event`	エージェントを実行するための GitHub モックイベント
`--token`	GitHub 個人アクセストークン

mcp

モデルコンテキストプロトコルサーバーを管理します。

aicippy-code mcp [command]

add

MCP サーバーを構成に追加します。

aicippy-code mcp add

このコマンドは、ローカルまたはリモートの MCP サーバーを追加する手順を示します。

list

構成されているすべての MCP サーバーとその接続ステータスをリストします。

aicippy-code mcp list

または、短いバージョンを使用してください。

aicippy-code mcp ls

auth

OAuth 対応の MCP サーバーで認証します。

aicippy-code mcp auth [name]

サーバー名を指定しない場合は、利用可能な OAuth 対応サーバーから選択するように求められます。

OAuth 対応サーバーとその認証ステータスを一覧表示することもできます。

aicippy-code mcp auth list

または、短いバージョンを使用してください。

aicippy-code mcp auth ls

logout

MCP サーバーの OAuth 資格情報を削除します。

aicippy-code mcp logout [name]

debug

MCP サーバーの OAuth 接続の問題をデバッグします。

aicippy-code mcp debug <name>

models

構成されたプロバイダーから利用可能なすべてのモデルをリストします。

aicippy-code models [provider]

このコマンドは、構成されたプロバイダー全体で利用可能なすべてのモデルを provider/model の形式で表示します。

これは、設定で使用する正確なモデル名を把握するのに役立ちます。

オプションでプロバイダー ID を渡して、そのプロバイダーによってモデルをフィルターできます。

aicippy-code models anthropic

フラグ

フラグ	説明
`--refresh`	models.aicippy.com からモデルキャッシュを更新します。
`--verbose`	より詳細なモデル出力を使用します (コストなどのメタデータを含む)

--refresh フラグを使用して、キャッシュされたモデルリストを更新します。これは、新しいモデルがプロバイダーに追加され、それを AicippY で確認したい場合に便利です。

aicippy-code models --refresh

run

プロンプトを直接渡して、非対話モードで aicippy-code を実行します。

aicippy-code run [message..]

これは、スクリプト作成、自動化、または完全な TUI を起動せずに迅速な回答が必要な場合に便利です。例えば。

aicippy-code run Explain the use of context in Go

実行中の aicippy-code serve インスタンスにアタッチして、実行ごとの MCP サーバーのコールドブート時間を回避することもできます。

# Start a headless server in one terminal
aicippy-code serve

# In another terminal, run commands that attach to it
aicippy-code run --attach http://localhost:4096 "Explain async/await in JavaScript"

フラグ

フラグ	ショート	説明
`--command`		実行するコマンド。引数には message を使用します。
`--continue`	`-c`	最後のセッションを続行
`--session`	`-s`	続行するセッション ID
`--fork`		続行時にセッションをフォーク (`--continue` または `--session` と併用)
`--share`		セッションを共有する
`--model`	`-m`	プロバイダー/モデルの形式で使用するモデル
`--agent`		使用するエージェント
`--file`	`-f`	メッセージに添付するファイル
`--format`		形式: デフォルト (フォーマット済み) または json (生の JSON イベント)
`--title`		セッションのタイトル (値が指定されていない場合は、切り詰められたプロンプトが使用されます)
`--attach`		実行中の aicippy-code サーバー (http://localhost:4096 など) に接続します。
`--password`	`-p`	Basic 認証パスワード（デフォルトは `AICIPPY_CODE_SERVER_PASSWORD`）
`--username`	`-u`	Basic 認証ユーザー名（デフォルトは `AICIPPY_CODE_SERVER_USERNAME` または `aicippy-code`）
`--dir`		実行ディレクトリ、またはアタッチ時のリモートサーバー上のパス
`--variant`		モデルバリアント（プロバイダー固有の推論レベル）
`--thinking`		思考ブロックを表示
`--port`		ローカルサーバーのポート (デフォルトはランダムポート)

serve

API アクセスのためにヘッドレス AicippY サーバーを起動します。完全な HTTP インターフェイスについては、サーバーのドキュメントを確認してください。

aicippy-code serve

これにより、TUI インターフェイスを使用せずに aicippy-code 機能への API アクセスを提供する HTTP サーバーが起動します。 AICIPPY_CODE_SERVER_PASSWORD を設定して HTTP 基本認証を有効にします (ユーザー名のデフォルトは aicippy-code)。

フラグ

フラグ	説明
`--port`	リッスンするポート
`--hostname`	リッスンするホスト名
`--mdns`	mDNS 検出を有効にする
`--cors`	CORS を許可する追加のブラウザーオリジン

session

AicippY セッションを管理します。

aicippy-code session [command]

list

すべての AicippY セッションをリストします。

aicippy-code session list

フラグ

フラグ	ショート	説明
`--max-count`	`-n`	最新のセッションを N 個に制限
`--format`		出力形式: テーブルまたは json (テーブル)

stats

AicippY セッションのトークンの使用状況とコストの統計を表示します。

aicippy-code stats

フラグ

フラグ	説明
`--days`	過去 N 日間の統計を表示 (全期間)
`--tools`	表示するツールの数 (すべて)
`--models`	モデルの使用状況の内訳を表示 (デフォルトでは非表示)。上位 N 件を表示するには数値を渡します
`--project`	プロジェクトでフィルタリング (全プロジェクト、空文字列: 現在のプロジェクト)

export

セッションデータを JSON としてエクスポートします。

aicippy-code export [sessionID]

セッション ID を指定しない場合は、利用可能なセッションから選択するように求められます。

import

JSON ファイルまたは AicippY 共有 URL からセッションデータをインポートします。

aicippy-code import <file>

ローカルファイルまたは AicippY 共有 URL からインポートできます。

aicippy-code import session.json
aicippy-code import https://opncd.ai/s/abc123

web

Web インターフェイスを使用してヘッドレス AicippY サーバーを起動します。

aicippy-code web

これにより、HTTP サーバーが起動し、Web ブラウザが開き、Web インターフェイスを通じて AicippY にアクセスします。 AICIPPY_CODE_SERVER_PASSWORD を設定して HTTP 基本認証を有効にします (ユーザー名のデフォルトは aicippy-code)。

フラグ

フラグ	説明
`--port`	リッスンするポート
`--hostname`	リッスンするホスト名
`--mdns`	mDNS 検出を有効にする
`--cors`	CORS を許可する追加のブラウザーオリジン

acp

ACP (エージェントクライアントプロトコル) サーバーを起動します。

aicippy-code acp

このコマンドは、nd-JSON を使用して stdin/stdout 経由で通信する ACP サーバーを起動します。

フラグ

フラグ	説明
`--cwd`	作業ディレクトリ
`--port`	リッスンするポート
`--hostname`	リッスンするホスト名

uninstall

AicippY をアンインストールし、関連ファイルをすべて削除します。

aicippy-code uninstall

フラグ

フラグ	ショート	説明
`--keep-config`	`-c`	構成ファイルを保持する
`--keep-data`	`-d`	セッションデータとスナップショットを保持する
`--dry-run`		削除せずに削除される内容を表示する
`--force`	`-f`	確認プロンプトをスキップする

upgrade

aicippy-code を最新バージョンまたは特定のバージョンに更新します。

aicippy-code upgrade [target]

最新バージョンにアップグレードするには。

aicippy-code upgrade

特定のバージョンにアップグレードするには。

aicippy-code upgrade v0.1.48

フラグ

フラグ	ショート	説明
`--method`	`-m`	使用されたインストール方法。curl, npm, pnpm, bun, brew

グローバルフラグ

aicippy-code CLI は次のグローバルフラグを受け取ります。

フラグ	ショート	説明
`--help`	`-h`	ヘルプを表示
`--version`	`-v`	バージョン番号を出力
`--print-logs`		ログを標準エラー出力に出力
`--log-level`		ログレベル (DEBUG、INFO、WARN、ERROR)

環境変数

AicippY は環境変数を使用して構成できます。

変数	タイプ	説明
`AICIPPY_CODE_AUTO_SHARE`	ブール値	セッションを自動的に共有する
`AICIPPY_CODE_GIT_BASH_PATH`	文字列	Windows 上で実行可能な Git Bash へのパス
`AICIPPY_CODE_CONFIG`	文字列	構成ファイルへのパス
`AICIPPY_CODE_CONFIG_DIR`	文字列	config ディレクトリへのパス
`AICIPPY_CODE_CONFIG_CONTENT`	文字列	インライン JSON 構成コンテンツ
`AICIPPY_CODE_DISABLE_AUTOUPDATE`	ブール値	自動更新チェックを無効にする
`AICIPPY_CODE_DISABLE_PRUNE`	ブール値	古いデータのプルーニングを無効にする
`AICIPPY_CODE_DISABLE_TERMINAL_TITLE`	ブール値	ターミナルタイトルの自動更新を無効にする
`AICIPPY_CODE_PERMISSION`	文字列	インライン化された json 権限設定
`AICIPPY_CODE_DISABLE_DEFAULT_PLUGINS`	ブール値	デフォルトのプラグインを無効にする
`AICIPPY_CODE_DISABLE_LSP_DOWNLOAD`	ブール値	LSP サーバーの自動ダウンロードを無効にする
`AICIPPY_CODE_ENABLE_EXPERIMENTAL_MODELS`	ブール値	実験モデルを有効にする
`AICIPPY_CODE_DISABLE_AUTOCOMPACT`	ブール値	自動コンテキスト圧縮を無効にする
`AICIPPY_CODE_DISABLE_CLAUDE_CODE`	ブール値	`.claude` からの読み取りを無効にする (プロンプト + スキル)
`AICIPPY_CODE_DISABLE_CLAUDE_CODE_PROMPT`	ブール値	`~/.claude/CLAUDE.md` の読み取りを無効にする
`AICIPPY_CODE_DISABLE_CLAUDE_CODE_SKILLS`	ブール値	`.claude/skills` のロードを無効にする
`AICIPPY_CODE_DISABLE_MODELS_FETCH`	ブール値	リモートソースからのモデルの取得を無効にする
`AICIPPY_CODE_FAKE_VCS`	文字列	テスト目的の偽の VCS プロバイダー
`AICIPPY_CODE_CLIENT`	文字列	クライアント識別子 (デフォルトは `cli`)
`AICIPPY_CODE_ENABLE_EXA`	ブール値	Exa Web 検索ツールを有効にする
`AICIPPY_CODE_SERVER_PASSWORD`	文字列	`serve`/`web` の基本認証を有効にする
`AICIPPY_CODE_SERVER_USERNAME`	文字列	基本認証ユーザー名 (デフォルト `aicippy-code`) をオーバーライドします。
`AICIPPY_CODE_MODELS_URL`	文字列	モデル設定を取得するためのカスタム URL

実験的

これらの環境変数により、変更または削除される可能性のある実験的な機能が有効になります。

変数	タイプ	説明
`AICIPPY_CODE_EXPERIMENTAL`	ブール値	アンブレラフラグ配下の実験的機能を有効にする
`AICIPPY_CODE_EXPERIMENTAL_ICON_DISCOVERY`	ブール値	アイコン検出を有効にする
`AICIPPY_CODE_EXPERIMENTAL_DISABLE_COPY_ON_SELECT`	ブール値	TUI で選択時のコピーを無効にする
`AICIPPY_CODE_EXPERIMENTAL_BASH_DEFAULT_TIMEOUT_MS`	数値	bash コマンドのデフォルトのタイムアウト (ミリ秒)
`AICIPPY_CODE_EXPERIMENTAL_OUTPUT_TOKEN_MAX`	数値	LLM 応答の最大出力トークン
`AICIPPY_CODE_EXPERIMENTAL_FILEWATCHER`	ブール値	ディレクトリ全体のファイル監視を有効にする
`AICIPPY_CODE_EXPERIMENTAL_OXFMT`	ブール値	oxfmt フォーマッタを有効にする
`AICIPPY_CODE_EXPERIMENTAL_LSP_TOOL`	ブール値	実験的な LSP ツールを有効にする
`AICIPPY_CODE_EXPERIMENTAL_DISABLE_FILEWATCHER`	ブール値	ファイルウォッチャーを無効にする
`AICIPPY_CODE_EXPERIMENTAL_EXA`	ブール値	実験的な Exa 機能を有効にする
`AICIPPY_CODE_EXPERIMENTAL_LSP_TY`	ブール値	python ファイルの TY LSP を有効にする
`AICIPPY_CODE_EXPERIMENTAL_PLAN_MODE`	ブール値	プランモードを有効にする
`AICIPPY_CODE_EXPERIMENTAL_BACKGROUND_SUBAGENTS`	ブール値	バックグラウンド subagent タスクを有効にする
`AICIPPY_CODE_EXPERIMENTAL_EVENT_SYSTEM`	ブール値	実験的なイベントシステムを有効にする
`AICIPPY_CODE_EXPERIMENTAL_NATIVE_LLM`	ブール値	ネイティブ LLM リクエスト経路を有効にする
`AICIPPY_CODE_EXPERIMENTAL_PARALLEL`	ブール値	並列 Web 検索実行を有効にする
`AICIPPY_CODE_EXPERIMENTAL_SCOUT`	ブール値	Scout subagent を有効にする
`AICIPPY_CODE_EXPERIMENTAL_WORKSPACES`	ブール値	ワークスペースサポートを有効にする