gpt/docs/commands.md

コマンドリファレンス

chat - AIと会話

ユーザーとAIの対話を処理し、関係性を更新します。

ai-gpt chat USER_ID MESSAGE [OPTIONS]

引数

• USER_ID: ユーザーID（atproto DID形式）
• MESSAGE: 送信するメッセージ

オプション

• --provider: AIプロバイダー（ollama/openai）
• --model, -m: 使用するモデル
• --data-dir, -d: データディレクトリ

例

# 基本的な会話
ai-gpt chat "did:plc:user123" "こんにちは"

# OpenAIを使用
ai-gpt chat "did:plc:user123" "調子はどう？" --provider openai --model gpt-4o-mini

# Ollamaでカスタムモデル
ai-gpt chat "did:plc:user123" "今日の天気は？" --provider ollama --model llama2

status - 状態確認

AIの状態や特定ユーザーとの関係を表示します。

ai-gpt status [USER_ID] [OPTIONS]

引数

• USER_ID: （オプション）特定ユーザーとの関係を確認

例

# AI全体の状態
ai-gpt status

# 特定ユーザーとの関係
ai-gpt status "did:plc:user123"

fortune - 今日の運勢

AIの今日の運勢を確認します。

ai-gpt fortune [OPTIONS]

表示内容

• 運勢値（1-10）
• 連続した幸運/不運の日数
• ブレークスルー状態

relationships - 関係一覧

すべてのユーザーとの関係を一覧表示します。

ai-gpt relationships [OPTIONS]

表示内容

• ユーザーID
• 関係性ステータス
• スコア
• 送信可否
• 最終対話日

transmit - 送信実行

送信可能なユーザーへのメッセージを確認・実行します。

ai-gpt transmit [OPTIONS]

オプション

• --dry-run/--execute: ドライラン（デフォルト）または実行
• --data-dir, -d: データディレクトリ

例

# 送信内容を確認（ドライラン）
ai-gpt transmit

# 実際に送信を実行
ai-gpt transmit --execute

maintenance - メンテナンス

日次メンテナンスタスクを実行します。

ai-gpt maintenance [OPTIONS]

実行内容

• 関係性の時間減衰
• 記憶の忘却処理
• コア記憶の判定
• 記憶の要約作成

config - 設定管理

設定の確認・変更を行います。

ai-gpt config ACTION [KEY] [VALUE]

アクション

• get: 設定値を取得
• set: 設定値を変更
• delete: 設定を削除
• list: 設定一覧を表示

例

# APIキーを設定
ai-gpt config set providers.openai.api_key sk-xxxxx

# 設定を確認
ai-gpt config get providers.openai.api_key

# 設定一覧
ai-gpt config list

# プロバイダー設定のみ表示
ai-gpt config list providers

schedule - スケジュール管理

定期実行タスクを管理します。

ai-gpt schedule ACTION [TASK_TYPE] [SCHEDULE] [OPTIONS]

アクション

• add: タスクを追加
• list: タスク一覧
• enable: タスクを有効化
• disable: タスクを無効化
• remove: タスクを削除
• run: スケジューラーを起動

タスクタイプ

• transmission_check: 送信チェック
• maintenance: 日次メンテナンス
• fortune_update: 運勢更新
• relationship_decay: 関係性減衰
• memory_summary: 記憶要約

スケジュール形式

• Cron形式: "0 */6 * * *" (6時間ごと)
• インターバル: "30m", "2h", "1d"

例

# 30分ごとに送信チェック
ai-gpt schedule add transmission_check "30m"

# 毎日午前3時にメンテナンス
ai-gpt schedule add maintenance "0 3 * * *"

# タスク一覧
ai-gpt schedule list

# スケジューラーを起動
ai-gpt schedule run

server - MCP Server

AIの記憶と機能をMCPツールとして公開します。

ai-gpt server [OPTIONS]

オプション

• --host, -h: サーバーホスト（デフォルト: localhost）
• --port, -p: サーバーポート（デフォルト: 8000）
• --model, -m: AIモデル
• --provider: AIプロバイダー

例

# 基本的な起動
ai-gpt server

# カスタム設定
ai-gpt server --port 8080 --model gpt-4o-mini --provider openai