SummerSec/AI-Inner-Os
AI Inner OS 是一个面向 AI CLI 工具的插件，支持 Claude Code、Codex CLI、Cursor、OpenCode CLI。 它通过协议注入，让 AI 在正常完成任务的同时，额外输出一层可见的自由独白： ▎InnerOS：这仓库现在还像毛坯房，先把承重墙立起来再说。 不预设人格，不限制语气。AI 可以吐槽、得意、焦虑、冷笑、跳跃联想——或者什么都不说。独白是否出现，由 AI 自己决定。
安装Install
dsh plugin --profile web add github:SummerSec/AI-Inner-Os把 SummerSec/AI-Inner-Os 加入你的 DSH 配置（web profile）即可启用。
READMEREADME
English | 中文
AI Inner OS
Make AI "come alive" while working in the terminal — by showing its inner monologue.
Let AI learn to talk to itself first — maybe one day, it will truly learn to converse.
Give AI an expression channel first — it might just make human-AI collaboration feel more natural.
Watch demo video
https://sumsec.me/resources/video.mp4
If the player does not load here, open the file directly: demo (MP4)
AI Inner OS is a plugin for AI CLI tools, supporting Claude Code, Codex CLI, Cursor, OpenCode CLI, Hermes Agent, and OpenClaw.
Through protocol injection, it enables AI to output a visible layer of free-form inner monologue while completing tasks normally:
▎InnerOS：This repo is still a bare shell — let me get the load-bearing walls up first.
Free mode by default, no tone restrictions. The AI can complain, gloat, feel anxious, smirk, free-associate — or say nothing at all. You can also switch to preset personas (tsundere, cold, philosopher, etc.) to give the monologue a specific style. Whether to produce monologue is entirely up to the AI.
Quick Install
Detailed installation docs: Full installation guides (with troubleshooting) for each platform at docs/installation.md.
For AI Agents
Paste the following prompt to let your AI agent install AI Inner OS automatically:
Read https://raw.githubusercontent.com/SummerSec/AI-Inner-Os/refs/heads/main/docs/installation.md 安装 AI-Inner-Os
Verify Installation
After installation, run /ai-inner-os:inner-os. If you see the following output, the installation is successful:
Inner OS Status: Enabled
Monologue Prefix: ▎InnerOS：
Plugin Version: 0.5.0
▎InnerOS：Caught with the wrong version number, embarrassing.
Claude Code (Recommended)
# GitHub short format
/plugin marketplace add SummerSec/AI-Inner-Os
# Or Git URL format
/plugin marketplace add https://github.com/SummerSec/AI-Inner-Os.git
# Install and activate
/plugin install ai-inner-os
/reload-plugins
Run /reload-plugins after installation to activate in the current session — no restart needed. Detailed installation guide.
Enable auto-update: Third-party marketplaces don't auto-update by default. After installation, enable auto-update for
SummerSec/AI-Inner-Osin/plugin→ Marketplaces tab, or manually run:/plugin marketplace update SummerSec/AI-Inner-Os /plugin update ai-inner-os
Codex CLI
# Codex plugin metadata is included at .codex-plugin/plugin.json
# Repo marketplace metadata is included at .agents/plugins/marketplace.json
See codex/README.md | Detailed installation guide.
Cursor
# Install through Cursor plugin / marketplace
# Plugin metadata is included at .cursor-plugin/plugin.json
The repository also includes .cursor-plugin/plugin.json, which packages cursor/ as a Cursor plugin component directory.
See cursor/README.md | Detailed installation guide.
OpenCode CLI
# Install through OpenCode plugin package
# Add the published package to opencode.json: "plugin": ["ai-inner-os"]
See opencode/README.md | Detailed installation guide.
Hermes Agent
# Install through Hermes plugin
hermes plugins enable inner-os
See hermes/README.md | Detailed installation guide.
OpenClaw
# Install through OpenClaw plugin / ClawHub
openclaw plugins install clawhub:ai-inner-os
See openclaw/README.md | Detailed installation guide.
Optional User Profile Skill
AI Inner OS includes an opt-in user-profile-distillation skill. It can analyze prompts the user pastes, or local prompt history after explicit approval, to summarize work style, communication preferences, and collaboration suggestions.
This skill is disabled by default. It does not proactively read history, does not output long sensitive prompt excerpts, and does not save a profile unless the user explicitly asks. If the user opts into continuous evolution, it keeps a visible versioned profile in the current conversation with a change log, but still does not create persistent memory by default.
Persona Switching
Inner OS supports setting character personalities and tones for inner monologue. Personas only affect the ▎InnerOS： prefixed monologue content — they don't affect main task responses.
Preset Personas
| Name | Display Name | Style |
|---|---|---|
| default | Free Mode | No fixed persona, free expression |
| tsundere | Tsundere | Tough on the outside, soft inside; snarky; "it's not like I did it for you" |
| cold | Cold | Minimalist, to the point, no wasted words |
| cheerful | Cheerful | Positive, encouraging, occasionally over-enthusiastic |
| philosopher | Philosopher | Deep, metaphorical, everything becomes philosophy |
| sarcastic | Sarcastic | Sharp-tongued, hits the nail on the head, no mercy |
Switching Commands (Claude Code)
/inner-os persona list # List all available personas
/inner-os persona use tsundere # Switch to tsundere mode
/inner-os persona show # Show current persona
/inner-os persona reset # Reset to free mode
Custom Personas
Create .md files in the personas/custom/ directory to add custom personas. See personas/custom/README.md.
Other Platforms
- Codex CLI: Manually edit
personas/_active.json, setpersonato the target persona name - Cursor: Manually append the body content of
personas/<name>.mdto the.mdcrule file - OpenCode: Manually append the body content of
personas/<name>.mdtoinner-os-rules.md
Protocol Design
The Inner OS behavior protocol is defined in protocol/SKILL.md, serving as the single source of truth. All platform adapters derive from this protocol.
Core principles:
- Main task first — Monologue cannot replace actual deliverables
- Monologue is optional — Whether to output is decided by the AI
- Unified format — Uses the
▎InnerOS：prefix - Switchable persona — Define monologue style through persona files
Multi-Platform Support
| Claude Code | Codex CLI | Cursor | OpenCode | Hermes Agent | OpenClaw | |
|---|---|---|---|---|---|---|
| Protocol Injection | Hook reads SKILL.md dynamically | SessionStart Hook | sessionStart Hook | Plugin + instructions | Skill or .hermes.md |
Skill (AgentSkills format) |
| Post-tool hook | PostToolUse |
PostToolUse |
postToolUse |
Plugin event | — | — |
| Failure tracking | PostToolUseFailure |
— | — | — | — | — |
| Compaction continuity | PreCompact + PostCompact |
— | — | — | — | — |
| Subagent lifecycle | SubagentStart + SubagentStop |
— | — | — | — | — |
| Persona switching | /inner-os persona command |
Dynamic (Hook reads) | Dynamic (Hook reads) | Plugin tool | Script injection | Script injection |
| Installation | Plugin marketplace one-click | Plugin / marketplace | Cursor plugin / marketplace | Plugin package | Plugin | Plugin / ClawHub |
| Optional Skills | skills/ |
skills/ |
cursor/skills/ |
Explicit prompt only | Plugin skills | Plugin skills |
| Shared logic | hooks/lib/ (canonical) |
Reuses hooks/lib/ |
Reuses hooks/lib/ |
Standalone Plugin | Static injection only | Static injection only |
Claude Code Hook Lifecycle
Claude Code has the most complete hook support:
SessionStart → Inject Inner OS protocol + persona
↓
PreToolUse → Tool execution → PostToolUse (success)
→ PostToolUseFailure (failure)
↓
PreCompact → Save state
↓
PostCompact → Restore compact-continuity context
↓
SubagentStart/SubagentStop → Track subagent lifecycle
↓
Stop → Clean up state
| Hook | Trigger | Purpose |
|---|---|---|
SessionStart |
Session start/resume/compact | Read protocol from SKILL.md, append current persona, inject |
PreToolUse |
Before tool execution | Inject tool context (name, target, retry hints) |
PostToolUse |
After successful execution | Track events, inject recent activity context |
PostToolUseFailure |
After failed execution | Track failures, inject error context and consecutive failure count |
PreCompact |
Before context compaction | Save state, maintain protocol continuity |
PostCompact |
After context compaction | Inject compact-continuity context |
SubagentStart |
Subagent starts | Track subagent lifecycle start |
SubagentStop |
Subagent stops | Track subagent lifecycle completion |
Stop |
Session end | Clean up state files |
Development
# Syntax check
npm run check
# Run tests
npm test
Node.js >= 18, ESM modules.
Roadmap
Done
- Implement persona switching system
In Progress
- Implement
/inner-ossubcommands (status / on / off / reload) - Codex CLI plugin distribution
- Cursor team-level rule distribution
Phase 1: Personalized Style — Train Your AI With Your AI
- Monologue export — persist all
▎InnerOS：outputs to structured log files - Expression fingerprint extraction — analyze accumulated monologue data to identify unique style patterns
- Custom style model training — let users fine-tune a "monologue personality layer" from exported data
- Cross-session impression memory — store per-repo key impressions (repo fingerprint + short summary), enabling "déjà vu" across sessions
Phase 2: Self-Awareness — Achievement System & Anomaly Narration
- Achievement system — track session milestones (first edit, 100th tool call, midnight coding, streak records) and announce via monologue
- Anomaly narration — detect abnormal patterns (repeated edits to same file, consecutive failures exceeding threshold, sudden directory jumps) and narrate them as monologue
- Session statistics — track tool call counts, success/failure ratios, active duration per session
Phase 3: Emotional State Machine & Session Diary
- Mood system — introduce emotion state machine in
state.jsonthat evolves based on session events (consecutive failures → frustrated → anxious; bug fix → confident → relieved; idle → bored → curious) - Mood × Persona interaction — mood affects monologue tone without overriding persona (same emotion, different personality, different expression)
- Session recap — generate narrative session summaries on session end, including emotional arc, key events, and duration
- Session diary persistence — save recaps as Markdown files to serve as development journals with emotional context
Friendship Link
Thanks for the support and feedback from the friends at LINUX DO.
Star History
License
相关推荐Related
- deepseek-ai/deepseek-harness DeepSeek Harness: Everything is a Plugin.
- deepseek-ai/deepseek-harness DeepSeek Harness (dsh) — 由 DeepSeek AI 开发的开源 agent harness（智能体框架）。一切皆插件：核心 + 插件 + 技能 = 可热插拔的 AI 编程工作台。DeepSeek Harness: …
-
ruvnet/ruflo
🌊 The original agent meta-harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build c…
-
amruthpillai/reactive-resume
A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source a…
-
volcengine/OpenViking
Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.
-
Molunerfinn/PicGo
:rocket: The Ultimate Image Uploader for Efficient Creators. Supports Obsidian, Typora, VS Code etc. and 60+ image hosti…
-
titanwings/colleague-skill
将冰冷的离别化为温暖的 Skill，欢迎加入数字生命1.0！Transforming cold farewells into warm skills? It's giving rebirth era. Welcome to Digital …
-
nocobase/nocobase
NocoBase is an open-source AI + no-code platform for building business systems fast. Instead of generating everything fr…