English | 中文

AI가 먼저 스스로에게 말하는 법을 배우게 하세요 — 언젠가는 진정으로 대화하는 법을 배우게 될지도 모릅니다.

AI에게 먼저 표현 채널을 제공하세요 — 그러면 인간과 AI의 협업이 훨씬 더 자연스럽게 느껴질 수도 있습니다.

AI Inner OS는 AI CLI 도구를 위한 플러그인으로, Claude Code, Codex CLI, Cursor, OpenCode CLI, Hermes Agent, 그리고 OpenClaw를 지원합니다.

프로토콜 주입 (Protocol injection)을 통해, AI가 작업을 정상적으로 수행하는 동안 가시적인 형태의 자유로운 내적 독백 (Inner monologue) 레이어를 출력할 수 있게 합니다:

▎InnerOS：이 저장소는 아직 빈 껍데기입니다 — 우선 하중을 견딜 벽부터 세워야겠어요.

기본적으로 자유 모드이며, 말투에 제한이 없습니다. AI는 불평하거나, 뽐내거나, 불안해하거나, 비웃거나, 자유 연상을 하거나 — 혹은 아무 말도 하지 않을 수 있습니다. 또한 사전 설정된 페르소나 (츤데레, 냉담함, 철학자 등)로 전환하여 독백에 특정 스타일을 부여할 수도 있습니다. 독백을 생성할지 여부는 전적으로 AI의 결정에 달려 있습니다.

상세 설치 문서: 각 플랫폼별 전체 설치 가이드(문제 해결 포함)는 docs/installation.md에서 확인할 수 있습니다.

AI 에이전트가 AI Inner OS를 자동으로 설치하도록 하려면 다음 프롬프트를 붙여넣으세요:

Read https://raw.githubusercontent.com/SummerSec/AI-Inner-Os/refs/heads/main/docs/installation.md 安装 AI-Inner-Os

설치 후, /ai-inner-os:inner-os를 실행하세요.

다음과 같은 출력이 보인다면 설치에 성공한 것입니다:

Inner OS Status: Enabled
Monologue Prefix: ▎InnerOS：
Plugin Version: 0.5.0
...

# GitHub short format
/plugin marketplace add SummerSec/AI-Inner-Os
# Or Git URL format
...

설치 후 /reload-plugins를 실행하여 현재 세션에서 활성화하세요 — 재시작은 필요하지 않습니다. 상세 설치 가이드.

자동 업데이트 활성화: 제3자 마켓플레이스는 기본적으로 자동 업데이트를 지원하지 않습니다. 설치 후, /plugin

→ Marketplaces 탭에서 SummerSec/AI-Inner-Os에 대한 자동 업데이트를 활성화하거나, 수동으로 다음을 실행하세요:
/plugin marketplace update SummerSec/AI-Inner-Os /plugin update ai-inner-os

Codex 플러그인 메타데이터는 .codex-plugin/plugin.json에 포함되어 있습니다.

Repo 마켓플레이스(marketplace) 메타데이터는 .agents/plugins/marketplace.json에 포함되어 있습니다.

codex/README.md 참조 | 상세 설치 가이드.

# Cursor 플러그인 / 마켓플레이스(marketplace)를 통해 설치
# 플러그인 메타데이터는 .cursor-plugin/plugin.json에 포함되어 있습니다.

이 저장소에는 cursor/를 Cursor 플러그인 컴포넌트 디렉토리로 패키징하는 .cursor-plugin/plugin.json도 포함되어 있습니다.

cursor/README.md 참조 | 상세 설치 가이드.

# OpenCode 플러그인 패키지를 통해 설치
# 발행된 패키지를 opencode.json에 추가: "plugin": ["ai-inner-os"]

opencode/README.md 참조 | 상세 설치 가이드.

# Hermes 플러그인을 통해 설치
hermes plugins enable inner-os

hermes/README.md 참조 | 상세 설치 가이드.

# OpenClaw 플러그인 / ClawHub를 통해 설치
openclaw plugins install clawhub:ai-inner-os

openclaw/README.md 참조 | 상세 설치 가이드.

AI Inner OS에는 선택 사항인 user-profile-distillation (사용자 프로필 증류) 기술이 포함되어 있습니다. 이 기술은 사용자가 붙여넣은 프롬프트나, 명시적인 승인 후의 로컬 프롬프트 기록 (local prompt history)을 분석하여 작업 스타일, 커뮤니케이션 선호도 및 협업 제안을 요약할 수 있습니다.

이 기술은 기본적으로 비활성화되어 있습니다. 능동적으로 기록을 읽지 않으며, 민감한 긴 프롬프트 발췌본을 출력하지 않고, 사용자가 명시적으로 요청하지 않는 한 프로필을 저장하지 않습니다. 사용자가 지속적인 진화 (continuous evolution)를 선택하는 경우, 변경 로그와 함께 현재 대화 내에 가시적인 버전 관리 프로필을 유지하지만, 여전히 기본적으로는 영구적인 메모리 (persistent memory)를 생성하지 않습니다.

Inner OS는 내부 독백 (inner monologue)을 위한 캐릭터 페르소나 (character personalities)와 톤 (tones) 설정을 지원합니다. 페르소나는 ▎InnerOS： 접두사가 붙은 독백 내용에만 영향을 미치며, 주요 작업 응답에는 영향을 주지 않습니다.

이름	표시 이름	스타일
default	Free Mode	고정된 페르소나 없음, 자유로운 표현
...

/inner-os persona list # 사용 가능한 모든 페르소나 목록 표시
/inner-os persona use tsundere # tsundere 모드로 전환
/inner-os persona show # 현재 페르소나 표시
...

커스텀 페르소나를 추가하려면 personas/custom/ 디렉토리에 .md 파일을 생성하세요. 자세한 내용은 personas/custom/README.md를 참조하십시오.

Codex CLI: personas/_active.json을 수동으로 편집하여 persona를 대상 페르소나 이름으로 설정하세요.
Cursor: personas/<name>.md의 본문 내용을 .mdc 규칙 파일에 수동으로 추가하세요.
OpenCode: personas/<name>.md의 본문 내용을 inner-os-rules.md에 수동으로 추가하세요.

Inner OS 동작 프로토콜은 protocol/SKILL.md에 정의되어 있으며, 이는 단일 진실 공급원 (Single Source of Truth) 역할을 합니다. 모든 플랫폼 어댑터는 이 프로토콜을 기반으로 파생됩니다.

핵심 원칙:

주요 작업 우선 (Main task first) — 독백 (Monologue)이 실제 결과물을 대체할 수 없습니다.
독백은 선택 사항 (Monologue is optional) — 출력 여부는 AI가 결정합니다.
통일된 형식 (Unified format) — ▎InnerOS： 접두사를 사용합니다.
전환 가능한 페르소나 (Switchable persona) — 페르소나 파일을 통해 독백 스타일을 정의합니다.

| Claude Code | Codex CLI | Cursor | OpenCode | Hermes Agent | OpenClaw | |
|---|---|---|---|---|---||
| 프로토콜 인젝션 (Protocol Injection) | Hook이 SKILL.md를 동적으로 읽음 | SessionStart Hook | sessionStart Hook | 플러그인 (Plugin) + 지침 (instructions) | Skill 또는 .hermes.md | Skill (AgentSkills 형식) |
| 도구 사용 후 훅 (Post-tool hook) | PostToolUse | PostToolUse | postToolUse | 플러그인 이벤트 (Plugin event) | — | — |
| 실패 추적 (Failure tracking) | PostToolUseFailure | — | — | — | — | — |
| 압축 연속성 (Compaction continuity) | PreCompact + PostCompact | — | — | — | — | — |
| 하위 에이전트 생명주기 (Subagent lifecycle) | SubagentStart + SubagentStop | — | — | — | — | — |
| 페르소나 전환 (Persona switching) | /inner-os persona 명령 | 동적 (Hook이 읽음) |

Hook	Trigger	Purpose
SessionStart	세션 시작/재개/압축 (Session start/resume/compact)	SKILL.md에서 프로토콜을 읽고, 현재 페르소나를 추가하여 주입 (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) 시작 시	서브에이전트 생명주기 시작 추적 (Track subagent lifecycle start)
SubagentStop	서브에이전트(Subagent) 종료 시	서브에이전트 생명주기 완료 추적 (Track subagent lifecycle completion)
Stop	세션 종료 (Session end)	상태 파일 정리 (Clean up state files)

# Syntax check
npm run check
# Run tests
...

Node.js >= 18, ESM 모듈 (ESM modules).

• 페르소나 전환 (Persona switching) 시스템 구현

• /inner-os 서브커맨드 (status / on / off / reload) 구현 - Codex CLI 플러그인 배포

• Cursor 팀 수준의 규칙 배포

• 독백 (Monologue) 내보내기 — 모든 ▎InnerOS： 출력을 구조화된 로그 파일로 유지

• 표현 지문 (Expression fingerprint) 추출 — 누적된 독백 데이터를 분석하여 고유한 스타일 패턴 식별

• 커스텀 스타일 모델 학습 — 사용자가 내보낸 데이터로부터 "독백 페르소나 레이어 (monologue personality layer)"를 미세 조정 (Fine-tune) 할 수 있도록 지원

• 세션 간 인상 메모리 (Cross-session impression memory) — 저장소별 주요 인상(저장소 지문 + 짧은 요약)을 저장하여 세션 간 "데자뷔 (déjà vu)" 가능하게 함

• 업적 시스템 (Achievement system) — 세션 마일스톤(첫 편집, 100번째 도구 호출, 자정 코딩, 연속 기록 등)을 추적하고 독백을 통해 알림

• 이상 징후 서사 (Anomaly narration) — 비정상적인 패턴(동일 파일에 대한 반복 편집, 임계값을 초과하는 연속 실패, 갑작스러운 디렉토리 점프)을 감지하고 이를 독백으로 서술

• 세션 통계 (Session statistics) — 도구 호출 횟수, 성공/실패 비율, 세션당 활성 시간을 추적

• 기분 시스템 (Mood system) — state.json에 감정 상태 머신 (Emotion state machine) 도입

• 세션 이벤트에 따라 진화하는 감정 상태 머신 (Emotion state machine) — (연속된 실패 → 좌절 → 불안; 버그 수정 → 자신감 → 안도; 유휴 상태 → 지루함 → 호기심)

• 기분(Mood) × 페르소나(Persona) 상호작용 — 기분은 페르소나를 덮어쓰지 않으면서 독백의 톤에 영향을 미침 (동일한 감정이라도 성격에 따라 표현이 달라짐)

• 세션 요약 (Session recap) — 세션 종료 시 감정적 흐름(Emotional arc), 주요 이벤트, 지속 시간을 포함한 서사적 세션 요약 생성

• 세션 일기 영속성 (Session diary persistence) — 요약본을 Markdown 파일로 저장하여 감정적 맥락이 담긴 개발 일지로 활용

LINUX DO 친구들의 지원과 피드백에 감사드립니다.