airiscode (Agiletec Inc)

airiscode

终端第一自主编码运行器 它通过统一的界面编排多个CLI编码助手（Claude Code、Codex、Gemini CLI、Aider）。

 ](https://github.com/agiletec-inc/airiscode) 

状态：预Alpha（v0.1.0）-实现框架完成（93%）

______________________________________________________________________

🌟 AIRIS生态系统的一部分

AIRISCode是 终端第一编码代理 的 AIRIS套房 -为自主编码提供统一的CLI接口。

AIRIS套房

MCP服务器（通过网关提供）

• airis mcp suabase自宿主 -支持RLS的自托管Supabase MCP
• Mindbase 的 -内存搜索和存储工具(mindbase_search, mindbase_store)

快速安装：完整的AIRIS套件

# Option 1: Install airis-agent plugin (recommended for Claude Code users)
/plugin marketplace add agiletec-inc/airis-agent
/plugin install airis-agent

# Option 2: Clone all AIRIS repositories at once
uv run airis-agent install-suite --profile core

# Option 3: Just use airiscode standalone
npm install -g @airiscode/cli
airiscode "your task"

全套套房为您带来：

• ✅ 信任门控工作流程（防止错误的方向编码）
• ✅ 深入研究与证据综合
• ✅ 通过存储库索引减少94%的令牌
• ✅ 跨所有编辑器的跨会话内存
• ✅ 自我审查和实施后验证

______________________________________________________________________

特性

• 🤖 多LLM支持：OpenAI、Anthropic、谷歌、Ollama、MLX
• 🔌 CLI适配器：Codex、Claude Code、Gemini CLI、Aider的统一接口
• 🛡️ 外壳防护装置：阻止危险命令（rm-rf/、docker系统修剪等）
• 🔐 策略管理：可配置的批准和信任级别
• 🧠 MindBase集成：使用pgvector的局部语义记忆
• 🔧 MCP网关：通过AIRIS MCP网关动态加载工具
• 📊 文本用户界面：用Ink构建的漂亮终端UI

安装

对于用户

Homebrew（推荐用于macOS/Linux）

# Add Agiletec tap
brew tap agiletec-inc/tap

# Install AIRIS Code
brew install airiscode

# Verify installation
airiscode --version

npm（替代）

# Install globally
npm install -g @airiscode/cli

# Verify installation
airiscode --version

对于开发者

先决条件：

• Node.js>=20.0.0
• pnpm>=8.0.0（安装： npm install -g pnpm)

设置：

# Clone the repository
git clone https://github.com/agiletec-inc/airiscode.git
cd airiscode

# Install dependencies + generate proto stubs + verify
make setup

# Or manually:
make check-deps  # Check pnpm/buf installation
make install     # Install dependencies
make codegen     # Generate TS/Go stubs from proto
make build       # Build all packages

# Run tests
make test

# Link globally for local development
pnpm link --global

# Verify installation
airiscode --version

发展

# Show all available commands
make help

# Watch mode for all packages
pnpm dev

# Run linter
make lint

# Run tests with coverage
make test-coverage

# Run tests in watch mode
make test-watch

# Clean build artifacts
make clean

可用的生成命令

make help             # Show this help
make check-deps       # Check if required dependencies are installed
make install          # Install all dependencies
make build            # Build all packages via Turbo
make lint             # Lint all packages
make test             # Run all tests
make test-watch       # Run tests in watch mode
make test-coverage    # Run tests with coverage
make test-unit        # Run unit tests only (faster)
make clean            # Clean generated files and build artifacts

项目结构

airiscode/
├── apps/
│   └── airiscode-cli/          # Main CLI application
├── packages/
│   ├── types/                  # Shared TypeScript types
│   ├── policies/               # Policy profiles
│   ├── sandbox/                # Shell Guard
│   ├── drivers/                # LLM drivers
│   ├── adapters/               # CLI adapters
│   ├── mcp/                    # MCP client & registry
│   ├── runners/                # Git/Docker/Test runners
│   ├── super-agent/            # Super Agent runtime wrapper
│   ├── mindbase/               # MindBase client
│   └── ux/                     # Common UI components
└── tools/
    └── make/                   # Build scripts

用法

# Shorthand - execute task directly
airiscode "Add a /health endpoint to the API"

# With options
airiscode "Refactor authentication" --adapter claude-code --policy sandboxed --verbose

# Explicit code command (also works)
airiscode code "Add authentication feature"

# Interactive mode with restricted access
airiscode "Review security" --policy restricted

# Use specific adapter and driver
airiscode "Fix bug #123" --adapter claude-code --driver ollama

# JSON output for CI/CD
airiscode "Run tests" --json

# Configuration management
airiscode config --list
airiscode config --set defaultDriver=ollama

# Session management
airiscode session --list
airiscode session --show 
airiscode session --resume 

政策级别

批准级别

• never：完全自主，无需用户批准
• on-failure：发生错误时暂停用户输入（默认）
• on-request：执行操作前需要明确的用户批准

信任级别

• restricted：只读文件系统，shell已禁用
• sandboxed：允许工作区写入，阻止外部网络（默认）
• untrusted：完全访问权限，但壳牌卫士仍阻止危险命令

建筑

看 建筑技术.md 获取详细的架构文档。

实施计划

看 实施计划规划.md 详细的实施路线图。

开发状态

电流相位：第5阶段完成✅

已完成的阶段

• \[x\] 第0阶段-基础 （3包）

- @airiscode/types -常见类型和结果模式 - @airiscode/policies -安全策略（批准级别、信任级别） - @airiscode/sandbox -带拒绝列表的ShellGuard

• \[x\] 第1阶段-核心接口 （2包）

- @airiscode/drivers -ModelDriver抽象类 - @airiscode/adapters -AdapterProcess抽象类

• \[x\] 第2阶段-实施 （2包）

- @airiscode/drivers-local -Ollama流媒体驱动程序 - @airiscode/adapters-claude-code -Claude Code CLI适配器

• \[x\] 第3阶段-MCP集成 （2包）

- @airiscode/mcp-client -带缓存的MCP网关客户端 - @airiscode/mcp-registry -工具搜索和调用跟踪

• \[x\] 第四阶段-跑步者 （3包）

- @airiscode/runners-git -Git操作（状态、提交、推送、补丁） - @airiscode/runners-docker -Docker操作（编写、运行状况、统计数据） - @airiscode/runners-test -多框架测试运行器（7个框架）

• \[x\] 第5阶段-CLI （1包）

- @airiscode/cli -基于Commander.js的CLI，包含3个命令 - 速记命令支持： airiscode "task" - 会话管理 - 配置管理

统计

• 总包数: 13
• 文件总数: 141
• 代码行: 14,180+
• 测试文件: 13
• 测试覆盖率：全面（2500多行测试）

贡献

请阅读 贡献.md 发展指南。

许可证

MIT许可证-请参阅 许可证 了解详情。

相关项目

• 超级特工 -信心门控和深入研究
• MindBase 的 -局部语义记忆
• AIRIS MCP网关 -MCP服务器聚合

文档

用户指南

• QUICKSTART.md -设置指南和使用示例
• CLAUDE.md -Claude Code项目指南
• 建筑技术.md -系统架构与设计

开发者指南

• 集成_指南.md -将新组件与现有代码集成
• IMPLEMENTATION_STATUS.md -进度跟踪和优先TODO
• 验证_报告.md -实施验证和验收标准
• 代理商.md -存储库指南和编码标准
• 软件包/适配器/README.md -适配器实施指南

出版

• 发布.md -npm和Homebrew发布指南