a50fef9182
Implemented a generic alternative to Claude Code with the following features: Core Implementation: - Multi-LLM provider support (OpenAI compatible APIs) - Function calling for direct tool execution by LLM - Interactive REPL shell interface - MCP server mode for Claude Desktop integration - Shell executor with bash, read, write, list tools Architecture: - src/cli: Interactive REPL implementation - src/llm: LLM provider abstraction (OpenAI compatible) - src/shell: Shell execution engine with duct - src/mcp: MCP server for Claude Desktop - src/config: Configuration management Technical Stack: - Rust 2021 with tokio async runtime - clap for CLI framework - reqwest for HTTP client - duct for shell execution - rustyline for REPL interface This tool integrates with aigpt to form AIOS (AI Operating System), enabling AI-driven OS management and automation. Based on aigpt architecture for CLI and MCP patterns.
178 lines
4.1 KiB
Markdown
178 lines
4.1 KiB
Markdown
# aishell
|
||
|
||
**AI-powered shell automation tool** - A generic alternative to Claude Code
|
||
|
||
## Overview
|
||
|
||
aishellは、AIがシェルを操作するための汎用的なツールです。Claude Codeのような機能を、より柔軟で拡張可能な形で提供します。
|
||
|
||
**主な特徴:**
|
||
- **マルチLLMプロバイダー対応**: OpenAI、Claude、ローカルLLM（gpt-oss等）
|
||
- **Function Calling**: LLMがツールを直接呼び出してシェルを操作
|
||
- **MCPサーバー**: Claude Desktopとの連携も可能
|
||
- **AIOS統合**: aigptと組み合わせてAIによるOS管理を実現
|
||
|
||
## Installation
|
||
|
||
```bash
|
||
# Rust環境が必要
|
||
cargo build --release
|
||
|
||
# バイナリをインストール
|
||
cargo install --path .
|
||
```
|
||
|
||
## Usage
|
||
|
||
### 1. 対話型シェル (Interactive Shell)
|
||
|
||
```bash
|
||
# OpenAI互換APIを使用
|
||
export OPENAI_API_KEY="your-api-key"
|
||
aishell shell
|
||
|
||
# 別のモデルを指定
|
||
aishell shell -m gpt-4o
|
||
|
||
# gpt-ossなどのOpenAI互換サーバーを使用
|
||
export OPENAI_BASE_URL="http://localhost:8080/v1"
|
||
aishell shell
|
||
```
|
||
|
||
**使用例:**
|
||
```
|
||
aishell> List all Rust files in src/
|
||
[Executing tool: list]
|
||
src/main.rs
|
||
src/lib.rs
|
||
...
|
||
|
||
aishell> Create a new file hello.txt with "Hello, World!"
|
||
[Executing tool: write]
|
||
Successfully wrote to file: hello.txt
|
||
|
||
aishell> Show me the git status
|
||
[Executing tool: bash]
|
||
On branch main
|
||
...
|
||
```
|
||
|
||
### 2. ワンショット実行 (Single Command)
|
||
|
||
```bash
|
||
aishell exec "Show me the current directory structure"
|
||
```
|
||
|
||
### 3. MCPサーバーモード (Claude Desktop Integration)
|
||
|
||
```bash
|
||
aishell server
|
||
```
|
||
|
||
**Claude Desktop設定** (`~/Library/Application Support/Claude/claude_desktop_config.json`):
|
||
```json
|
||
{
|
||
"mcpServers": {
|
||
"aishell": {
|
||
"command": "/path/to/aishell",
|
||
"args": ["server"]
|
||
}
|
||
}
|
||
}
|
||
```
|
||
|
||
## Architecture
|
||
|
||
```
|
||
aishell/
|
||
├── src/
|
||
│ ├── cli/ # 対話型インターフェイス (REPL)
|
||
│ ├── llm/ # LLMプロバイダー (OpenAI互換)
|
||
│ ├── shell/ # シェル実行エンジン
|
||
│ ├── mcp/ # MCPサーバー実装
|
||
│ └── config/ # 設定管理
|
||
```
|
||
|
||
**実行フロー:**
|
||
```
|
||
User Input → LLM (Function Calling) → Tool Execution → Shell → Result → LLM → User
|
||
```
|
||
|
||
## Available Tools
|
||
|
||
aishellは以下のツールをLLMに提供します:
|
||
|
||
- **bash**: シェルコマンドを実行
|
||
- **read**: ファイルを読み込み
|
||
- **write**: ファイルに書き込み
|
||
- **list**: ファイル一覧を取得
|
||
|
||
## Environment Variables
|
||
|
||
| 変数 | 説明 | デフォルト |
|
||
|------|------|----------|
|
||
| `OPENAI_API_KEY` | OpenAI APIキー | (必須) |
|
||
| `OPENAI_BASE_URL` | APIベースURL | `https://api.openai.com/v1` |
|
||
| `OPENAI_MODEL` | 使用するモデル | `gpt-4` |
|
||
|
||
## Integration with AIOS
|
||
|
||
aishellは[aigpt](https://github.com/syui/aigpt)と組み合わせることで、AIOS（AI Operating System）の一部として機能します:
|
||
|
||
- **aigpt**: AIメモリー、パーソナリティ分析
|
||
- **aishell**: シェル操作、自動化
|
||
- **AIOS**: これらを統合したAIによるOS管理システム
|
||
|
||
## Comparison with Claude Code
|
||
|
||
| 機能 | Claude Code | aishell |
|
||
|------|------------|---------|
|
||
| LLM | Claude専用 | **マルチプロバイダー** |
|
||
| 実行環境 | Electron Desktop | **CLI/MCP** |
|
||
| カスタマイズ | 限定的 | **完全制御** |
|
||
| ローカルLLM | 非対応 | **対応可能** |
|
||
| AIOS統合 | 不可 | **ネイティブ対応** |
|
||
|
||
## Development
|
||
|
||
```bash
|
||
# 開発ビルド
|
||
cargo build
|
||
|
||
# テスト実行
|
||
cargo test
|
||
|
||
# ログ有効化
|
||
RUST_LOG=debug aishell shell
|
||
```
|
||
|
||
## Technical Stack
|
||
|
||
- **Language**: Rust 2021
|
||
- **CLI**: clap 4.5
|
||
- **Async Runtime**: tokio 1.40
|
||
- **HTTP Client**: reqwest 0.12
|
||
- **Shell Execution**: duct 0.13
|
||
- **REPL**: rustyline 14.0
|
||
|
||
## Roadmap
|
||
|
||
- [ ] Anthropic Claude API対応
|
||
- [ ] Ollama対応（ローカルLLM）
|
||
- [ ] より高度なツールセット（git統合、ファイル検索等）
|
||
- [ ] 設定ファイルサポート
|
||
- [ ] セッション履歴の永続化
|
||
- [ ] プラグインシステム
|
||
|
||
## License
|
||
|
||
MIT License
|
||
|
||
## Author
|
||
|
||
syui
|
||
|
||
## Related Projects
|
||
|
||
- [aigpt](https://github.com/syui/aigpt) - AI Memory System
|