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-Os in /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, set persona to the target persona name
• Cursor: Manually append the body content of personas/<name>.md to the .mdc rule file
• OpenCode: Manually append the body content of personas/<name>.md to inner-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-os subcommands (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.json that 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

Apache-2.0