xelyon-cli

XELYON CLI

⚠️ このプロジェクトは開発中です / This project is under development

一部の機能は不安定な場合があります。フィードバックは Issues へお願いします。

AI搭載のコーディングアシスタントCLIツール

特徴

• 🌐 6種類のLLMプロバイダー対応: DeepSeek, OpenAI, Gemini, Claude, Ollama, Groq
• 💬 対話型エージェント: 29種類のツールで実際にコード編集・Git操作を実行
• 📋 Plan Mode: AIが実装計画を立てて、承認後に自動実行（並列処理対応）
• 🤖 Headlessモード: JSON出力で他のツールから呼び出し可能
• ↩️ Undo機能: ファイル変更の取り消し（バックアップから復元）
• 🧠 メモリ機能: プロジェクト別・グローバル記憶の永続化
• 📂 会話履歴管理: セッションをJSONL形式で保存・復元
• 🗺️ Repo Map: Tree-sitterでコード構造を自動解析
• 🔌 MCP対応: Model Context Protocol による外部ツール連携

インストール

Homebrew（macOS）

brew install susugadx/tap/xelyon

バイナリダウンロード

GitHub Releasesから環境に合ったバイナリをダウンロード。

Linux/macOS:

# ダウンロード・展開例
wget https://github.com/susugadx/xelyon-cli/releases/latest/download/xelyon_linux_amd64.tar.gz
tar -xzf xelyon_linux_amd64.tar.gz
sudo mv xelyon /usr/local/bin/

Windows: xelyon_windows_amd64.zip をダウンロード・展開。

ソースからビルド

git clone https://github.com/susugadx/xelyon-cli.git
cd xelyon-cli
go build -o xelyon

クイックスタート

1. APIキーを設定

# .envファイル使用（推奨）
cp .env.example .env
# .env を編集してAPIキーを設定

# または環境変数で設定
export DEEPSEEK_API_KEY="sk-..."  # DeepSeek（デフォルト）
export OPENAI_API_KEY="sk-..."    # OpenAI
export GEMINI_API_KEY="..."       # Gemini
export ANTHROPIC_API_KEY="sk-ant-..." # Claude
export GROQ_API_KEY="gsk_..."     # Groq
# Ollama: ローカル実行のため不要

APIキーの取得方法: プロバイダー設定ガイド

2. 起動して対話

# インストール後（Homebrew または /usr/local/bin/ に配置）
xelyon

# ローカルビルド（プロジェクトディレクトリから）
./xelyon

> main.goを読んで、バグがあれば修正して

3. プロバイダー切り替え

# コマンドライン指定（インストール後）
xelyon --provider gemini --model gemini-2.0-flash-exp

# ローカルビルド
./xelyon --provider gemini --model gemini-2.0-flash-exp

# セッション中に切り替え
> /use openai gpt-4

基本的な使い方

対話コマンド

/help       # コマンド一覧
/memory add プロジェクトではReactを使う  # 記憶を追加
/plan on    # Plan Mode有効化
/use gemini # プロバイダー切り替え
/undo       # 最後の変更を取り消し
/exit       # 終了

全コマンド: コマンドリファレンス

複数行入力

プロンプトやコードを複数行で入力できます。

方法1: ``` マーカー

> ```
📝 Multiline input mode (end with ``` on a new line)
  1 | 以下のコードをレビューして
  2 |
  3 | func main() {
  4 |     fmt.Println("Hello")
  5 | }
  6 | ```
✅ Captured 5 lines

方法2: ペースト（Bracketed Paste Mode）

• コードエディタやブラウザから複数行をコピー＆ペースト
• 自動的に複数行として認識され、途中で実行されません
• 📋 Pasted N lines と表示されます
• ターミナルエミュレータがBracketed Paste Modeをサポートしている必要があります（大半の現代的なターミナルは対応済み）
  • 対応: iTerm2, Terminal.app, GNOME Terminal, Konsole, Windows Terminal, tmux, screen
  • 非対応の場合は方法1の ``` マーカーを使用してください

ツール例

AIが自動で以下のツールを使用します:

• ファイル編集: read_file, write_file, str_replace
• Git操作: git_status, git_diff, git_add, git_commit, git_push
• 開発支援: run_test, format, lint
• 検索: search_code, search_file, web_search

全ツール: コマンドリファレンス

Plan Mode

AIが実装計画を立てて、承認後に自動実行します。

# Plan Modeで起動（インストール後）
xelyon --plan "バグ修正とテストを実行"

# ローカルビルド
./xelyon --plan "バグ修正とテストを実行"

# セッション中に切り替え
> /plan on
> ユーザー認証機能を追加して

詳細: コマンドリファレンス - Plan Mode

メモリ機能

プロジェクト別・グローバル記憶を保存できます。

> /memory add プロジェクトではTypeScriptとReactを使う
> /memory list
> /memory delete <ID>

詳細: コマンドリファレンス - メモリ

ドキュメント

• コマンド一覧 - 全コマンド、29ツール、使用例
• プロバイダー設定 - DeepSeek, OpenAI, Gemini, Claude, Groq, Ollamaの設定方法
• 設定リファレンス - config.yamlと環境変数
• MCP連携 - Model Context Protocolで外部ツール追加

技術スタック

• Go 1.22+
• Cobra - CLIフレームワーク
• LLM APIs - DeepSeek, OpenAI, Gemini, Claude (Anthropic), Ollama, Groq
• Tree-sitter - コード構造解析

開発

# ビルド
go build -o xelyon

# テスト
go test ./...

# フォーマット
go fmt ./...

詳細なアーキテクチャと開発ガイド: XELYON.md

ライセンス

MIT

バージョン

最新リリース: GitHub Releases

変更履歴: CHANGELOG.md