aicortex（Python daemon）

用已批准的 python.exe 跑本地 agent runtime（跨 Windows / macOS / Linux），无需 Docker。

PyPI 包名是 aicortex-daemon（aicortex 与已有包 ai-cortex 过近被拒）；模块名仍是 aicortex。命令行用模块方式，避免与 Go CLI 二进制抢 PATH：

pip install aicortex-daemon
python -m aicortex --help

安装

从 PyPI

pip install -U aicortex-daemon

从源码（本仓库）

cd python-daemon
pip install -e .
# 或带发布工具：
pip install -e ".[dev]"

运行

# 方式 A：经 Go aicortex CLI（推荐；需已 pip 安装本包）
$env:AICORTEX_DAEMON_BACKEND = "python"
aicortex daemon start
aicortex daemon status
aicortex daemon stop

# 方式 B：直接启动
python -m aicortex start --foreground
python -m aicortex capabilities
python -m aicortex --version

需要 ~/.aicortex/config.json（token + server_url）以及 PATH 上的 agent CLI。

Health 默认端口 19514（与 Go / aicortex daemon status 一致）。不要与 Go daemon 同时跑在同一端口。

发布到 PyPI（对齐 aicorkit / aicortex-bridge）

在 python-daemon/ 目录：

python -m pip install -U build twine
python -m build
python -m twine upload dist/*

版本号改 pyproject.toml 的 version 与 aicortex/__init__.py 的 __version__（保持一致），再重新 build / upload。

已对齐能力（相对 Go daemon）

• 注册/心跳/wakeup/claim/cancel、agentEnv、prior_work_dir 复用
• Claude（stream-json + MCP --mcp-config）、Codex（+ semantic inactivity）
• Cursor/Gemini/OpenCode/Copilot stream-json/json 事件流
• Cursor/Kiro chat ACP 池；Kiro/Hermes/Kimi/Dsh ACP oneshot
• OpenClaw / pi 启动参数；OpenClaw config fail-closed
• Repo：allowlist + per-workspace bare + worktree 锁 + co-authored hook
• Design：handoff zip + example seed
• Model list：ACP discovery + 60s cache
• GC：.gc_meta.json + active-root 保护
• Wakeup 侧带：tunnel、artifact browse/chunk upload、terminal（pipe MVP，需 AICORTEX_DAEMON_TERMINAL_PTY=true）

仍偏薄 / partial：真正的 ConPTY/unix PTY（现为 pipe shell）、OS sandbox wrapper（bwrap/Seatbelt）、Go 式 auto-update（用 pip install -U aicortex-daemon）。

环境变量（节选）