# Agent Os

> An agent-native operating system — FUSE virtual filesystem + MCP protocol + Skill system + Agent Kernel for AI coding agents.

- **Type:** MCP server
- **Install:** `agentstack add mcp-buzzcut2190-agent-os`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [buzzcut2190](https://agentstack.voostack.com/s/buzzcut2190)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [buzzcut2190](https://github.com/buzzcut2190)
- **Source:** https://github.com/buzzcut2190/agent-os

## Install

```sh
agentstack add mcp-buzzcut2190-agent-os
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

让 AI coding agent 拥有「原生 OS 体验」

  
  
  
  

---

**agent-os** 是一个面向 AI coding agent 的原生操作系统。不是"给 AI 用的文件系统"，而是让 agent 可以真正「安家」的地方——有文件系统、有内核调度、有守护进程、有家目录。

当你把 agent-os 挂载到一个项目目录：

```bash
agentfs mount . .agentfs/mnt
```

你的项目立刻多了 13 个语义目录——AI agent 可以用 `ls` / `cat` 直接与项目交互，不需要任何 API 调用：

| 目录 | 它能做什么 |
|------|-----------|
| `@context` | 自动生成的项目摘要——技术栈、结构、统计 |
| `@search` | 按函数/类/符号/类型浏览代码 |
| `@graph` | 依赖图谱、调用图、导入关系（DOT 格式） |
| `@refactor` | 死代码检测、圈复杂度、lint 报告 |
| `@team` | 多 Agent 团队协作空间 |
| `@tasks` | 任务看板 + 依赖 DAG |
| `@skills` | 7 个内置技能——代码审查 / 测试生成 / 文档 / 提交信息 / 审计 等 |
| `@providers` | 5 个 LLM 提供商——Anthropic / OpenAI / DeepSeek / GLM / Ollama |
| `@memory` | 持久记忆——会话 / 决策 / 偏好 / 知识 |
| `@bridges` | 远程桥接——飞书 / Webhook |
| `@kernel` | Agent 内核——进程调度 / IPC / 资源控制 |
| `@daemon` | 守护进程——文件监控 / 定时任务 / 报告 / 挖掘 |
| `@workspaces` | Agent 家目录——团队空间 / 产出物管理 |

---

## 🚀 快速开始

```bash
# 1. 构建
make build

# 2. 初始化项目
agentfs init

# 3. 挂载
agentfs mount . .agentfs/mnt

# 4. 看看你的项目长什么样
cat .agentfs/mnt/@context

# 5. 启动 MCP Server（给 AI agent 调用）
agentfs-mcp serve --transport stdio
```

---

## 🧠 能力栈

```
                        🧠 Agent Kernel
                  调度 · 生命周期 · 资源 · IPC
                        👻 Agent Daemon
                  监控 · 定时 · 报告 · 挖掘
                        🏠 Agent Workspace
                  家目录 · 团队空间 · 记忆
                        🗂️ agentfs
                  13 虚拟目录 · 33 MCP 工具
```

### 四层架构

| 层 | 核心能力 |
|----|---------|
| **🗂️ agentfs** | FUSE 虚拟文件系统，13 个语义目录，所有功能都通过 `cat` / `ls` 原生暴露 |
| **🏠 Workspace** | 每个 Agent 的私有家目录、团队共享空间、分门别类的持久记忆（会话/决策/偏好/知识）、会话沙箱 |
| **👻 Daemon** | 文件变更监控、YAML 定时任务、定期报告生成推送、潜意识循环（空闲时自动发现模式） |
| **🧠 Kernel** | Agent 进程调度、全生命周期管理、资源配额控制、IPC 频道通信、Model Router 按任务路由 LLM |

### MCP 协议（33 个工具）

AI agent 也可以通过 MCP 协议调用：

| 类别 | 工具 |
|------|------|
| **文件** | `read_file` `write_file` `edit_file` `delete_file` `move_file` `list_dir` `search_files` |
| **代码** | `search_code` `grep_regex` `find_definition` `find_references` `get_file_summary` `count_loc` |
| **项目** | `get_context` `detect_stack` `list_dir` |
| **会话** | `create_session` `get_session` `list_sessions` `session_diff` `discard_session` `commit_session` |
| **技能** | `list_skills` `activate_skill` `deactivate_skill` `get_skill_context` |
| **提供商** | `list_providers` `get_provider` `list_models` `set_api_key` `set_default_model` `switch_provider` `test_provider` |
| **系统** | `ping` |

---

## 📦 会话沙箱

agent-os 提供基于文件复制的轻量级会话沙箱，AI agent 可以在一个隔离的副本中工作，修改完成后选择提交或丢弃。

**不需要 root 权限**，不依赖 OverlayFS，使用纯文件复制实现。

```bash
# 通过 MCP 工具创建会话（agent 自动在项目副本中工作）
# create_session → 复制项目文件到 .agentfs/sessions//

# 查看变更
# session_diff → 显示会话副本与原项目的差异

# 提交变更（将修改覆盖回原项目）
# commit_session → 复制修改文件回原项目

# 丢弃变更（删除副本）
# discard_session → 清理会话目录
```

工作流程：

```
  原项目                    会话沙箱
┌──────────┐    create    ┌──────────────┐
│ src/main.go│ ──────────→ │ src/main.go  │  (副本)
│ go.mod    │             │ go.mod       │
└──────────┘             └──────┬───────┘
                                │ 修改
                         ┌──────▼───────┐
                         │ src/main.go  │  (已修改)
                         └──────┬───────┘
                                │
                    ┌───────────┴───────────┐
                    │                       │
              commit_session          discard_session
                    │                       │
             ┌──────▼───────┐         ┌──────▼───────┐
             │ src/main.go  │         │  (已清理)     │
             │ (已更新)      │         └──────────────┘
             └──────────────┘
```

---

## ⚡ 技能系统

内置 7 个开箱即用的技能：

```bash
agentfs skill list
# → code-review   自动代码审查（安全/性能/风格/最佳实践）
# → test-generator  自动生成测试用例
# → commit-message  从 diff 生成提交信息
# → auto-doc       自动文档生成
# → architectural-review  架构审查（依赖图分析）
# → dependency-audit  依赖审计
# → feedback-synthesis  反馈综合
```

每个技能都有自己的 prompt + context 模板，AI agent 可以直接调用：

```bash
agentfs skill activate code-review
```

---

## 🛠️ Provider 配置

agent-os 支持 5 个 LLM 提供商：

```bash
# 交互式配置
agentfs provider init

# 设置 API Key（加密存储，不落明文）
agentfs provider key deepseek

# 验证
agentfs provider list
# → deepseek  openai-compatible  deepseek-chat,deepseek-v4-flash,deepseek-v4-pro  ok
```

支持：Anthropic · OpenAI · DeepSeek · GLM（智谱）· Ollama（本地）

---

## ❓ 为什么选择 agent-os？

| 特性 | agent-os | Cursor | Cline | Proma |
|------|----------|--------|-------|-------|
| **交互方式** | FUSE 文件系统 + MCP | IDE 插件 | IDE 插件 | CLI |
| **模型支持** | 模型无关，5+ 提供商 | 仅 OpenAI | 多提供商 | 有限 |
| **FUSE 原生** | ✅ 13 个语义目录 | ❌ | ❌ | ❌ |
| **会话沙箱** | ✅ 副本隔离，无需 root | ❌ | ❌ | ❌ |
| **多 Agent 协作** | ✅ 内核调度 + IPC | ❌ | ❌ | 部分 |
| **主动能力** | ✅ Daemon 守护进程 | ❌ | ❌ | ❌ |
| **部署形态** | 单二进制，无运行时依赖 | Electron 应用 | VS Code 扩展 | CLI |
| **语言** | Go | TypeScript | TypeScript | Rust |

agent-os 的独特优势：

- **FUSE 创新**：agent 通过 `ls`/`cat` 原生发现项目信息，零学习成本
- **模型无关内核**：不绑定任何 LLM 提供商，按任务类型智能路由
- **Daemon 主动能力**：文件监控、定时任务、潜意识挖掘，agent 不只是被动响应
- **轻量 Go 二进制**：单文件部署，无需 Node.js、Python 或其他运行时

---

## 🗺️ 路线图

### v0.6.0 (当前) — 桌面 GUI + Kernel 持久化
- [x] Tauri 桌面应用（挂载控制、13 目录浏览器、Agent 管理）
- [x] Kernel Agent 生命周期持久化 + Provider 热切换
- [x] `agentfs-mcp call` / `list-tools` CLI
- [x] `agentfs workspace` CLI 子命令
- [x] Session 后台守护进程挂载

### Phase C — 输出与控制
- [ ] 流式输出（SSE）支持
- [ ] 细粒度权限控制系统
- [ ] 操作审计日志

### Phase D — IDE 集成
- [ ] VS Code 扩展
- [ ] JetBrains 插件
- [ ] Neovim LSP 集成

### Phase E — 主动智能中心
- [ ] Proactive Center：基于 Daemon 事件的主动建议
- [ ] Agent 自进化：从历史会话学习优化策略
- [ ] 多项目 Workspace 联邦
- [ ] Web Dashboard

---

## 📖 文档

| 文档 | 说明 |
|------|------|
| [Architecture](docs/architecture.md) | 架构详解 |
| [Getting Started](docs/getting-started.md) | 快速入门 |
| [CLI Reference](docs/cli.md) | 命令参考 |
| [MCP Tools](docs/mcp-tools.md) | MCP 工具参考 |
| [CHANGELOG](CHANGELOG.md) | 版本变更记录 |

---

## 🐛 Troubleshooting

### 挂载报 `permission denied`

```bash
fusermount -uz .agentfs/mnt   # 先卸载残留
agentfs mount . .agentfs/mnt   # 重新挂载
```

### 挂载后读取文件报 `错误的文件描述符`

已修复（v0.4.0）。如遇到，请更新到最新版本后重新编译。

### Provider 配置注意

YAML 字段是 snake_case（`base_url`、`api_key`），`agentfs provider init` 会自动生成正确格式。

---

## 🤝 参与贡献

欢迎贡献！请遵循以下指南：

1. **Fork** 仓库，创建功能分支：`git checkout -b feat/my-feature`
2. **开发** 时遵循项目代码风格，确保 `make lint` 通过
3. **测试**：添加新功能时请补充单元测试，运行 `make test`
4. **提交**：使用语义化 commit message（feat/fix/docs/refactor）
5. **PR**：向 `main` 分支发起 Pull Request，描述清楚变更内容

详细架构请参考 [docs/architecture.md](docs/architecture.md)。

---

## 📜 License

[MIT](LICENSE) © 2026 [buzzcut2190](https://github.com/buzzcut2190)

---

  由 FUSE 驱动 · 用 Go 构建 · 为 AI agent 而生

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [buzzcut2190](https://github.com/buzzcut2190)
- **Source:** [buzzcut2190/agent-os](https://github.com/buzzcut2190/agent-os)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-buzzcut2190-agent-os
- Seller: https://agentstack.voostack.com/s/buzzcut2190
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.