update thinking
This commit is contained in:
176
README.md
176
README.md
@@ -1,177 +1,3 @@
|
|||||||
# aishell
|
# aishell
|
||||||
|
|
||||||
**AI-powered shell automation tool** - A generic alternative to Claude Code
|
A single-stream shell where commands and AI coexist — type a command, it runs; type anything else, AI responds.
|
||||||
|
|
||||||
## 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
|
|
||||||
|
|||||||
189
claude.md
189
claude.md
@@ -1,41 +1,168 @@
|
|||||||
# aishell
|
# aishell
|
||||||
|
|
||||||
|
A single-stream shell where commands and AI coexist.
|
||||||
|
|
||||||
## 概要
|
## Architecture
|
||||||
|
|
||||||
Claude Codeのような、AIがshellを操作するためのツール。
|
|
||||||
例えば、gpt-ossのようなllmを使用することを想定。場合によっては、MCPを駆使する。
|
|
||||||
|
|
||||||
## 主な機能
|
|
||||||
|
|
||||||
1. **マルチLLMプロバイダー対応**
|
|
||||||
- OpenAI API互換（OpenAI, gpt-oss, etc.）
|
|
||||||
- 将来的にClaude API、Ollamaなども対応予定
|
|
||||||
|
|
||||||
2. **Function Calling (Tool use)**
|
|
||||||
- LLMが直接ツールを呼び出してシェルを操作
|
|
||||||
- bash, read, write, list等のツールを提供
|
|
||||||
|
|
||||||
3. **MCPサーバーモード**
|
|
||||||
- Claude Desktopとの連携が可能
|
|
||||||
- aigptと同様のMCPプロトコル実装
|
|
||||||
|
|
||||||
## アーキテクチャ
|
|
||||||
|
|
||||||
```
|
```
|
||||||
User → CLI → LLM Provider → Function Calling → Shell Executor → Result
|
┌──────────────────────────────────────────────┐
|
||||||
|
│ aishell │
|
||||||
|
│ │
|
||||||
|
│ ┌──────────┐ judge ┌───────────────┐ │
|
||||||
|
│ │ rustyline │───────────→│ sh -c command │ │
|
||||||
|
│ │ (input) │ is_command └───────────────┘ │
|
||||||
|
│ └──────────┘ │
|
||||||
|
│ │ !is_command │
|
||||||
|
│ ▼ │
|
||||||
|
│ ┌──────────┐ stdin(JSON) ┌──────────────┐ │
|
||||||
|
│ │ send() │─────────────→│ claude │ │
|
||||||
|
│ │ (async) │ │ (persistent) │ │
|
||||||
|
│ └──────────┘ │ stream-json │ │
|
||||||
|
│ └──────────────┘ │
|
||||||
|
│ ┌──────────┐ stdout(JSON) │ │
|
||||||
|
│ │ reader │←────────────────────┘ │
|
||||||
|
│ │ thread │ mpsc channel │
|
||||||
|
│ └──────────┘ │
|
||||||
|
│ │ │
|
||||||
|
│ ▼ │
|
||||||
|
│ ┌──────────┐ │
|
||||||
|
│ │ drain() │──→ println! (unified stream) │
|
||||||
|
│ └──────────┘ │
|
||||||
|
│ │
|
||||||
|
│ ┌───────────────────────────────────────┐ │
|
||||||
|
│ │ ● [1] responding... | [2] thinking... │ │
|
||||||
|
│ └───────────────────────────────────────┘ │
|
||||||
|
└──────────────────────────────────────────────┘
|
||||||
```
|
```
|
||||||
|
|
||||||
## AIOS統合
|
## Claude Process (ai.rs)
|
||||||
|
|
||||||
- **aigpt**: メモリー、パーソナリティ分析
|
### Startup
|
||||||
- **aishell**: シェル操作、自動化
|
|
||||||
- **統合**: AIによるOS管理の実現
|
|
||||||
|
|
||||||
## 技術スタック
|
One persistent process for the entire session:
|
||||||
|
|
||||||
- Rust 2021
|
```
|
||||||
- tokio (async runtime)
|
claude --input-format stream-json --output-format stream-json \
|
||||||
- reqwest (HTTP client)
|
--verbose --dangerously-skip-permissions
|
||||||
- duct (shell execution)
|
```
|
||||||
- clap (CLI framework)
|
|
||||||
|
- `--input-format stream-json`: accepts JSON lines on stdin
|
||||||
|
- `--output-format stream-json`: emits JSON events on stdout
|
||||||
|
- Process stays alive until aishell exits. No restart per message.
|
||||||
|
|
||||||
|
### Input Format
|
||||||
|
|
||||||
|
```json
|
||||||
|
{"type":"user","message":{"role":"user","content":"user input here"}}
|
||||||
|
```
|
||||||
|
|
||||||
|
Written to claude's stdin via `Arc<Mutex<ChildStdin>>`.
|
||||||
|
|
||||||
|
### Output Events
|
||||||
|
|
||||||
|
```
|
||||||
|
type: "system" → init event (tools list, MCP servers, model info)
|
||||||
|
type: "assistant" → response content
|
||||||
|
content[].type: "text" → AI text (accumulated)
|
||||||
|
content[].type: "tool_use" → tool execution (name shown in status)
|
||||||
|
type: "result" → turn complete (final text, cost, usage)
|
||||||
|
```
|
||||||
|
|
||||||
|
### Thread Model
|
||||||
|
|
||||||
|
```
|
||||||
|
Main Thread Background Thread
|
||||||
|
│ │
|
||||||
|
├─ readline() ├─ BufReader::lines() on claude stdout
|
||||||
|
├─ judge::is_command() ├─ serde_json::from_str() each line
|
||||||
|
├─ command → executor::execute() ├─ "assistant" → accumulate text, update status
|
||||||
|
├─ AI → claude.send() (non-blocking) ├─ "tool_use" → update status
|
||||||
|
├─ drain_responses() before prompt ├─ "result" → mpsc::send() completed text
|
||||||
|
└─ status.set(status_line()) └─ remove session from status vec
|
||||||
|
|
||||||
|
Polling Thread (200ms interval)
|
||||||
|
├─ try_recv() completed responses → print immediately
|
||||||
|
└─ update status bar
|
||||||
|
```
|
||||||
|
|
||||||
|
### Shared State
|
||||||
|
|
||||||
|
```rust
|
||||||
|
stdin: Arc<Mutex<ChildStdin>> // main → claude stdin writes
|
||||||
|
status: Arc<Mutex<Vec<SessionStatus>>> // both threads read/write status
|
||||||
|
output_tx: mpsc::Sender<String> // background → main completed responses
|
||||||
|
output_rx: mpsc::Receiver<String> // main drains with try_recv()
|
||||||
|
id_tx: mpsc::Sender<usize> // main → background session ID assignment
|
||||||
|
```
|
||||||
|
|
||||||
|
### Non-blocking Send
|
||||||
|
|
||||||
|
```rust
|
||||||
|
pub fn send(&mut self, input: &str) -> usize {
|
||||||
|
let id = self.next_id; // assign session ID
|
||||||
|
self.next_id += 1;
|
||||||
|
status.push(SessionStatus { id, state: "thinking..." });
|
||||||
|
self.id_tx.send(id); // notify reader thread
|
||||||
|
writeln!(stdin, "{}", json); // write JSON to claude stdin
|
||||||
|
stdin.flush();
|
||||||
|
// returns immediately — does NOT wait for response
|
||||||
|
id
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
## Input Detection (judge.rs)
|
||||||
|
|
||||||
|
Priority order:
|
||||||
|
|
||||||
|
1. Shell operators (`|`, `>`, `<`, `;`, `&`) outside quotes → shell
|
||||||
|
2. Variable assignment (`FOO=bar`) → shell
|
||||||
|
3. Shell builtins (cd, echo, export, etc. — 50 builtins) → shell
|
||||||
|
4. Absolute/relative path to existing file → shell
|
||||||
|
5. Command found in PATH → shell
|
||||||
|
6. **None of the above → AI**
|
||||||
|
|
||||||
|
Quote-aware: operators inside `'...'` or `"..."` are ignored.
|
||||||
|
|
||||||
|
## Command Execution (executor.rs)
|
||||||
|
|
||||||
|
- `cd` → `env::set_current_dir()` (changes process directory)
|
||||||
|
- `cd -` → OLDPWD support, `~` → HOME expansion
|
||||||
|
- Everything else → `sh -c "input"` (pipes, redirects, globs all work)
|
||||||
|
|
||||||
|
## Status Bar (status.rs)
|
||||||
|
|
||||||
|
Terminal last line reserved for Claude status:
|
||||||
|
|
||||||
|
```
|
||||||
|
● idle ← waiting
|
||||||
|
● [1] thinking... ← processing
|
||||||
|
● [1] responding... ← generating text
|
||||||
|
● [1] running: Bash... ← executing tool
|
||||||
|
● [1] responding... | [2] thinking... ← multiple sessions
|
||||||
|
```
|
||||||
|
|
||||||
|
Implementation:
|
||||||
|
- ANSI escape `\x1b[1;{rows-1}r` sets scroll region excluding last line
|
||||||
|
- `\x1b7` save cursor → draw status on last row → `\x1b8` restore cursor
|
||||||
|
- Auto-cleanup on Drop (reset scroll region)
|
||||||
|
|
||||||
|
## Files
|
||||||
|
|
||||||
|
```
|
||||||
|
src/
|
||||||
|
├── main.rs Main loop: input → judge → execute/AI → drain responses
|
||||||
|
├── lib.rs Module declarations
|
||||||
|
├── ai.rs ClaudeManager: persistent process, async send/receive
|
||||||
|
├── judge.rs is_command(): input classification (6 tests)
|
||||||
|
├── executor.rs execute(): sh -c + cd handling
|
||||||
|
└── status.rs StatusBar: ANSI last-line status display
|
||||||
|
```
|
||||||
|
|
||||||
|
## Dependencies
|
||||||
|
|
||||||
|
```toml
|
||||||
|
rustyline = "14.0" # line input + history
|
||||||
|
serde = "1" # JSON serialization
|
||||||
|
serde_json = "1" # stream-json protocol parsing
|
||||||
|
terminal_size = "0.4" # terminal dimensions for status bar
|
||||||
|
```
|
||||||
|
|||||||
Reference in New Issue
Block a user