AI导哈

终端优先自主编码运行器

AIRISCode是一个终端优先的自主编码运行器，通过统一接口协调多个CLI编码助手（Claude Code、Codex、Gemini CLI、Aider），适用于开发自动化、代码生成和任务执行场景。

  • by agiletec-inc
  • TypeScript
  • 本地部署
  • 5 星标
  • 更新于
在 GitHub 查看 agiletec-inc/airiscode

使用说明

airiscode

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

状态：预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 11.x（仓库通过根管固定pnpm packageManager 现场和 pnpm-workspace.yaml)

设置：

# 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 <session-id>
airiscode session --resume <session-id>

政策级别

批准级别

  • 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许可证-请参阅 许可证 了解详情。

相关项目

文档

用户指南

开发者指南

出版

💖 支持

agiletec 是一个人的工作室，全职开源地构建这些工具。如果他们在你的工作流程中获得了一席之地，赞助会让他们保持独立。

相关 MCP