{"id":49921792,"url":"https://github.com/jzlikewei/persona-shell","last_synced_at":"2026-05-16T20:38:13.764Z","repository":{"id":351517502,"uuid":"1204752995","full_name":"jzlikewei/persona-shell","owner":"jzlikewei","description":"把你最顺手的 agent 当虾养","archived":false,"fork":false,"pushed_at":"2026-05-07T03:39:04.000Z","size":2088,"stargazers_count":10,"open_issues_count":0,"forks_count":2,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-07T05:34:19.137Z","etag":null,"topics":["ai-agent","bun","claude-code","feishu","lark","typescript"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jzlikewei.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-08T09:49:39.000Z","updated_at":"2026-04-29T16:18:33.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/jzlikewei/persona-shell","commit_stats":null,"previous_names":["jzlikewei/persona-shell"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/jzlikewei/persona-shell","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jzlikewei%2Fpersona-shell","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jzlikewei%2Fpersona-shell/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jzlikewei%2Fpersona-shell/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jzlikewei%2Fpersona-shell/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jzlikewei","download_url":"https://codeload.github.com/jzlikewei/persona-shell/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jzlikewei%2Fpersona-shell/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33118269,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-16T18:38:32.183Z","status":"ssl_error","status_checked_at":"2026-05-16T18:38:29.903Z","response_time":115,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-agent","bun","claude-code","feishu","lark","typescript"],"created_at":"2026-05-16T20:38:13.046Z","updated_at":"2026-05-16T20:38:13.757Z","avatar_url":"https://github.com/jzlikewei.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Persona Shell\n\n[![Test](https://github.com/jzlikewei/persona-shell/actions/workflows/test.yml/badge.svg)](https://github.com/jzlikewei/persona-shell/actions/workflows/test.yml)\n\n\u003e 把你最顺手的 agent 当虾养。\n\n你精心维护的 prompt 才是核心资产。Persona Shell 不造 agent，只让现成的 agent（Claude Code、Codex）用你的 prompt 来干活——接入 IM、7×24 替你在线。你只需要把 Markdown 写好。\n\n不知道怎么用？clone 下来，让你的 agent 来读。\n\n\u003e **⚠️ 早期项目**：仅在 macOS (Apple Silicon) 上开发和日常使用。Linux 理论可用但未验证，Windows 不支持（依赖 named pipe / mkfifo）。\n\n\u003e **⚠️ 安全提示**：Persona Shell 以 `--dangerously-skip-permissions` 模式运行 Claude Code，即 AI 可以无需确认地执行 shell 命令、读写文件。仅在你信任的机器上运行，不要暴露到公网。详见 [安装指南](docs/setup.md)。\n\n## TL;DR\n\n外挂IM，让Agent用你精心维护的prompt干活、并行干，后台干、定时干、用不同身份干。\n\n## 设计理念\n\n- **不重复造轮子** — agent 的推理、工具调用、代码能力已经被 Claude Code / Codex 做好了，Persona Shell 不重新实现这些，只做编排和消息转发\n- **Prompt 是你的核心资产** — soul.md（人格）、personas/（角色）、prompts/（系统行为模板）、memory/（记忆）—— 全部是 Markdown，你用 git 管理、精心迭代，这才是你的 AI 分身区别于别人的地方\n- **持久运行，自动刷新** — daemon 模式 + 自动上下文刷新（FLUSH），你维护的 prompt 和记忆会被持久保存，跨会话生效，不怕 context window 耗尽\n- **多实例，多后端** — 主分身 + 群聊 Director Pool，并行任务、后台任务、定时任务；同一套 prompt 可以被不同 agent 后端使用\n\n## 支持的 Agent 后端\n\n| Agent | 状态 |\n|-------|------|\n| [Claude Code](https://docs.anthropic.com/en/docs/claude-code) | ✅ 主力后端 |\n| [Codex](https://github.com/openai/codex) | ✅ 后台任务 + 群聊 Director |\n| [Kimi Code CLI](https://moonshotai.github.io/kimi-cli/) | ✅ 长驻 Director + 后台任务 |\n\n完整功能矩阵和详细用法见 [使用指南](docs/usage.md)。\n\n## 效果展示\n\n通过飞书和你的 agent 分身对话：\n![飞书会话](docs/feishu-chats.png)\n\nagent 自主产出结构化日报和工作记录：\n![日报](docs/daily-md.png)\n\nWeb 控制台查看运行状态：\n![Web 控制台](docs/webui-screenshot.png)\n\n## 快速开始\n\n```bash\ngit clone https://github.com/jzlikewei/persona-shell.git\ncd persona-shell\n\n# 一键初始化（安装依赖 + 创建身份仓库 + 配置飞书凭据）\nbun run init\n\n# 自定义你的分身（可选，推荐）\ncd ~/.persona \u0026\u0026 claude /soul-crafting\n\n# 启动\nbun run dev\n```\n\n需要先创建飞书应用，详见 [安装指南](docs/setup.md)。\n\n## 身份仓库结构\n\n你的 prompt 资产存放在 `~/.persona/`，由 git 管理：\n\n```\n~/.persona/\n├── soul.md              # 人格定义 — 你的 AI 分身是谁\n├── personas/            # 角色 — 不同场景下的行为模式\n├── prompts/             # 系统行为模板 — 编排指令\n├── memory/              # 记忆 — 跨会话持久保存\n├── daily/               # 日报与工作记忆\n├── TODO.md              # 待办事项\n└── config.yaml          # 运行配置\n```\n\n## 架构概览\n\n```\nIM 消息 → TS Shell → MessageQueue → SessionBridge (主 Director)\n              │                         │\n              │                    ┌────┴────┐\n              │                    │ Adapter  │ ← Claude / Codex 协议适配\n              │                    │ Runtime  │ ← 进程生命周期\n              │                    └─────────┘\n              │\n              │  群聊 → DirectorPool ─→ SessionBridge (群1, 群2, ...)\n              │\n              └── Web Console (localhost:3000)\n```\n\n技术细节见 [架构文档](docs/architecture.md)。\n\n## 文档\n\n| 文档 | 内容 |\n|------|------|\n| [安装与配置](docs/setup.md) | 飞书应用创建、配置文件、服务化、身份仓库 |\n| [使用指南](docs/usage.md) | 命令、群聊策略、任务、Cron、Web 控制台、人格自定义 |\n| [技术架构](docs/architecture.md) | 三层架构、通讯层、消息路由、FLUSH、进程容灾 |\n| [Agent 后端](docs/agent-backends.md) | Claude Code / Codex 启动机制、协议、参数、会话恢复 |\n| [运维速查](docs/ops-reference.md) | 命令、日志路径、运行时文件 |\n\n## License\n\n[MIT](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjzlikewei%2Fpersona-shell","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjzlikewei%2Fpersona-shell","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjzlikewei%2Fpersona-shell/lists"}