AIHouse

监控你的 AI Agent 在干什么。

一个开源的桌面应用，监控你所有 AI 编码 Agent 的任务状态。任务跑完了没、卡住了没、成功了没、花了多少钱——瞟一眼就知道。

🖥️ 界面预览

┌──── 系统托盘 ───────────────────┐
│ 🟢 AIHouse  ·  一切正常          │  ← 瞟一眼就知道状态
└─────────────────────────────────┘

┌──────────────────────────────────┐
│  AIHouse     14:30  全部正常 ✅   │
│──────────────────────────────────│
│  Claude Code  🟢 重构用户模块 3m  │  ← 每个 Agent 一行
│  Cursor       🔵 空闲            │
│  Hermes       🟢 生成文章 2m     │
│                                  │
│  📊 今日: 7完成 · 0失败 · 1卡住  │
│  💰 今日费用: $2.45              │
│                                  │
│  [历史] [设置] [刷新]              │
└──────────────────────────────────┘

✨ 功能

实时监控 — 系统托盘图标，颜色代表整体状态（绿/蓝/黄/红）
多 Agent 统一面板 — Claude Code、Cursor、Hermes、OpenCode 等在一个界面显示
任务追踪 — 每个 Agent 当前在跑什么任务、跑了多久
卡住检测 — Agent 长时间无活动自动告警
费用统计 — 每日 API 花费汇总，超预算自动通知
通知推送 — 微信推送（PushPlus）/ 桌面通知 / iOS（Bark）
历史记录 — 查看所有 Agent 的历史任务
自动检测 — 自动识别本机已安装的 Agent
跨平台 — macOS / Windows / Linux
轻量 — Python 后端 + Tauri 桌面端，打包仅 ~10MB

📦 安装

从 GitHub Releases 下载最新版 wheel 包安装。

macOS / Linux

pip install https://github.com/988hj7tczd-oss/aihouse/releases/download/v0.1.0/aihouse-0.1.0-py3-none-any.whl
aihouse init
aihouse start
aihouse status

Windows

pip install https://github.com/988hj7tczd-oss/aihouse/releases/download/v0.1.0/aihouse-0.1.0-py3-none-any.whl
aihouse init
aihouse start
aihouse status

后续上传 PyPI 后，只需 pip install aihouse

桌面端（可选）

桌面端提供系统托盘图标和可视化面板。

# 安装 Node.js：https://nodejs.org/
# 安装 Rust：https://rustup.rs/

cd desktop
npm install
npm run tauri dev     # 开发模式
npm run tauri build   # 打包安装程序

详细安装说明请查看安装指南

🚀 快速开始

# 1. 初始化配置
aihouse init

# 2. 检测本机 Agent
aihouse detect

# 3. 启动监控
aihouse start

# 4. 查看状态
aihouse status

# 5. 查看任务历史
aihouse tasks

# 6. 停止监控
aihouse stop

详细使用说明请查看快速开始

🤖 支持的 Agent

Agent	类型	监控方式	状态
Hermes	CLI 工具	读 state.db SQLite	✅ 稳定
Claude Code	CLI 工具	读 ~/.claude/logs/	✅ 稳定
Cursor	桌面应用	进程检测	✅ 稳定
Codex CLI	CLI 工具	进程检测	✅ 稳定
OpenCode	CLI 工具	读 SQLite	✅ 稳定
OpenClaw	CLI 工具	读 JSON/SQLite	✅ 稳定
Kilo Code	VS Code 插件	进程检测	⚠️ 基础
Cline	VS Code 插件	进程检测	⚠️ 基础
GitHub Copilot	VS Code 插件	进程检测	⚠️ 基础
通义灵码	VS Code 插件	进程检测	⚠️ 基础
通用模式	任意 Agent	进程 + 文件变化	✅ 兜底

📋 CLI 命令

命令	说明
`aihouse init`	初始化配置目录
`aihouse start`	启动后台监控
`aihouse stop`	停止监控
`aihouse restart`	重启监控
`aihouse status`	查看 Agent 状态
`aihouse tasks`	查看任务历史
`aihouse detect`	检测本机 Agent
`aihouse log`	查看运行日志
`aihouse desktop`	启动桌面端
`aihouse diagnose`	诊断适配器状态

完整命令参考请查看 CLI 命令

🏗️ 架构

┌──────────────────────────────────────┐
│  桌面端 (Tauri)                       │
│  ┌──────────┐  ┌──────────────────┐  │
│  │ 系统托盘  │  │ 弹出面板          │  │
│  │ 🟢🔵🟡🔴 │  │ Agent 状态列表   │  │
│  └──────────┘  │ 任务详情 / 历史   │  │
│                │ / 设置            │  │
│                └────────┬─────────┘  │
└─────────────────────────┼────────────┘
                          │ REST API
┌─────────────────────────┼────────────┐
│  后端 (Python)           │           │
│  ┌────────────────────────────────┐  │
│  │ 调度器 → 适配器 → 分析引擎     │  │
│  │                    ↓           │  │
│  │ SQLite 存储 ← 通知器 → 微信   │  │
│  └────────────────────────────────┘  │
└──────────────────────────────────────┘

详细架构说明请查看架构说明

📖 文档

文档	说明
快速开始	5 分钟上手
安装指南	Mac / Windows / Linux
CLI 命令	命令详解
配置说明	配置文件参考
桌面端使用	面板操作
架构说明	工作原理
适配器体系	Agent 适配
常见问题	排错指南
开发者指南	参与开发

🤝 参与贡献

欢迎提交 Pull Request 或 Issue！

📄 开源协议

MIT License

⭐ Star 历史

如果你觉得这个工具有用，欢迎点亮 Star ⭐

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

aihouse-0.1.0.tar.gz (34.7 kB view details)

Uploaded Jul 24, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

aihouse-0.1.0-py3-none-any.whl (50.6 kB view details)

Uploaded Jul 24, 2026 Python 3

File details

Details for the file aihouse-0.1.0.tar.gz.

File metadata

Download URL: aihouse-0.1.0.tar.gz
Upload date: Jul 24, 2026
Size: 34.7 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for aihouse-0.1.0.tar.gz
Algorithm	Hash digest
SHA256	`c991156e56cda1819e231201985b926708bb5a27c243339ce3b57077bde0caf9`
MD5	`7f9a7057f7358f74eccd79cbd2348ed2`
BLAKE2b-256	`d2db2215097f8cad7403e88196ff0274f07d01db46640361aec1ebd3c80631ee`

See more details on using hashes here.

Provenance

The following attestation bundles were made for aihouse-0.1.0.tar.gz:

Publisher: publish.yml on 988hj7tczd-oss/aihouse

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: aihouse-0.1.0.tar.gz
- Subject digest: c991156e56cda1819e231201985b926708bb5a27c243339ce3b57077bde0caf9
- Sigstore transparency entry: 2235200989
- Sigstore integration time: Jul 24, 2026
Source repository:
- Permalink: 988hj7tczd-oss/aihouse@37edd21076d17f71babd53ba19413da7db87ecfb
- Branch / Tag: refs/heads/main
- Owner: https://github.com/988hj7tczd-oss
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish.yml@37edd21076d17f71babd53ba19413da7db87ecfb
- Trigger Event: workflow_dispatch

File details

Details for the file aihouse-0.1.0-py3-none-any.whl.

File metadata

Download URL: aihouse-0.1.0-py3-none-any.whl
Upload date: Jul 24, 2026
Size: 50.6 kB
Tags: Python 3
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for aihouse-0.1.0-py3-none-any.whl
Algorithm	Hash digest
SHA256	`a826a42acd27659546891293dfd8a1c30ceae08c7cda1ce30d69a687400246a9`
MD5	`a93a219737e939371f33690f5db0fc4a`
BLAKE2b-256	`48b2a686fc928106ec33efdfce6c83d6974cf23295410bde224455fada4d0bc9`

See more details on using hashes here.

Provenance

The following attestation bundles were made for aihouse-0.1.0-py3-none-any.whl:

Publisher: publish.yml on 988hj7tczd-oss/aihouse

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: aihouse-0.1.0-py3-none-any.whl
- Subject digest: a826a42acd27659546891293dfd8a1c30ceae08c7cda1ce30d69a687400246a9
- Sigstore transparency entry: 2235201585
- Sigstore integration time: Jul 24, 2026
Source repository:
- Permalink: 988hj7tczd-oss/aihouse@37edd21076d17f71babd53ba19413da7db87ecfb
- Branch / Tag: refs/heads/main
- Owner: https://github.com/988hj7tczd-oss
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish.yml@37edd21076d17f71babd53ba19413da7db87ecfb
- Trigger Event: workflow_dispatch

Release history Release notifications | RSS feed

0.1.1

Jul 25, 2026 2 files

This release

0.1.0 This release

Jul 24, 2026 2 files

aihouse 0.1.0

AIHouse

🖥️ 界面预览

✨ 功能

📦 安装

macOS / Linux

Windows

桌面端（可选）

🚀 快速开始

🤖 支持的 Agent

📋 CLI 命令

🏗️ 架构

📖 文档

🤝 参与贡献

📄 开源协议

⭐ Star 历史

Key dates

1 maintainer

Requires

Download files

Source Distribution

Built Distribution

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

Release history Release notifications | RSS feed