# cyberxz2077/agent-brain-kit architecture

> Architecture diagram of the GitHub repository cyberxz2077/agent-brain-kit, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-28). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/cyberxz2077/agent-brain-kit
- Repository: https://github.com/cyberxz2077/agent-brain-kit

## Overview

agent-brain-kit installs a filesystem-based memory scaffold for CLI agents. The main workflow is to invoke an installer, which copies the Codex templates to a target directory, then use the scaffold’s load and retrieval rules: keep SOUL stable, maintain PREFERENCE, consult the MEMORY index, retrieve FLASHBACK summaries first, and expand into LOGS only when relevant. The repository also documents optional Kimi Code auto-loading. Installer source was sampled; template behavior and Kimi wiring are represented from README descriptions, not inspected runtime logic.

Main entry points: [`node/bin/ai-brain-init.js`](https://github.com/cyberxz2077/agent-brain-kit/blob/cyberxz2077/feat/publish-agent-brain-kit/node/bin/ai-brain-init.js) (Node installer), [`python/agent_memory_bootstrap/cli.py`](https://github.com/cyberxz2077/agent-brain-kit/blob/cyberxz2077/feat/publish-agent-brain-kit/python/agent_memory_bootstrap/cli.py) (Python installer), [`templates/Codex/kimi-code/kimi-conscious.yaml`](https://github.com/cyberxz2077/agent-brain-kit/blob/cyberxz2077/feat/publish-agent-brain-kit/templates/Codex/kimi-code/kimi-conscious.yaml) (Kimi agent config), [`templates/Codex/SOUL.md`](https://github.com/cyberxz2077/agent-brain-kit/blob/cyberxz2077/feat/publish-agent-brain-kit/templates/Codex/SOUL.md) (Stable principles)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_installers["Installers"]
  node_python_cli["Python installer<br/>[cli.py]"]
  node_node_cli["Node installer<br/>[ai-brain-init.js]"]
  node_shell_installer["Shell installer<br/>[install.sh]"]
end

subgraph group_memory["Memory scaffold"]
  node_soul["Stable principles<br/>[SOUL.md]"]
  node_preference["User preferences<br/>[PREFERENCE.md]"]
  node_agents["Load and retrieval rules<br/>[AGENTS.md]"]
  node_memory_index["Memory index<br/>[MEMORY.md]"]
  node_flashbacks["Flashback summaries"]
  node_logs["Full context logs"]
  node_brain_spec["Shareable brain spec<br/>[AI-Brain.md]"]
end

subgraph group_kimi["Kimi integration"]
  node_kimi_setup["Kimi setup script<br/>[setup-kimi-code.sh]"]
  node_kimi_config["Kimi agent config"]
  node_kimi_system["Kimi system prompt"]
end

node_user(("CLI user"))
node_target["Installed scaffold"]
node_kimi_cli(("Kimi Code CLI"))

node_user -->|"runs"| node_python_cli
node_user -->|"runs"| node_node_cli
node_user -->|"runs"| node_shell_installer
node_python_cli -->|"copies templates"| node_soul
node_python_cli -->|"copies templates"| node_preference
node_python_cli -->|"copies templates"| node_agents
node_python_cli -->|"copies templates"| node_memory_index
node_python_cli -->|"copies templates"| node_flashbacks
node_python_cli -->|"copies templates"| node_logs
node_python_cli -->|"copies templates"| node_brain_spec
node_python_cli -->|"writes scaffold"| node_target
node_node_cli -->|"copies templates"| node_soul
node_node_cli -->|"copies templates"| node_preference
node_node_cli -->|"copies templates"| node_agents
node_node_cli -->|"copies templates"| node_memory_index
node_node_cli -->|"copies templates"| node_flashbacks
node_node_cli -->|"copies templates"| node_logs
node_node_cli -->|"copies templates"| node_brain_spec
node_node_cli -->|"copies templates"| node_kimi_config
node_node_cli -->|"copies templates"| node_kimi_system
node_node_cli -->|"writes scaffold"| node_target
node_shell_installer -->|"installs scaffold"| node_target
node_user -.->|"runs optionally"| node_kimi_setup
node_kimi_setup -.->|"configures CLI"| node_kimi_config
node_kimi_cli -.->|"loads agent config"| node_kimi_config
node_kimi_config -.->|"loads principles"| node_soul
node_kimi_config -.->|"loads preferences"| node_preference
node_kimi_config -.->|"loads memory map"| node_memory_index

click node_python_cli "https://github.com/cyberxz2077/agent-brain-kit/blob/cyberxz2077/feat/publish-agent-brain-kit/python/agent_memory_bootstrap/cli.py"
click node_node_cli "https://github.com/cyberxz2077/agent-brain-kit/blob/cyberxz2077/feat/publish-agent-brain-kit/node/bin/ai-brain-init.js"
click node_shell_installer "https://github.com/cyberxz2077/agent-brain-kit/blob/cyberxz2077/feat/publish-agent-brain-kit/install.sh"
click node_soul "https://github.com/cyberxz2077/agent-brain-kit/blob/cyberxz2077/feat/publish-agent-brain-kit/templates/Codex/SOUL.md"
click node_preference "https://github.com/cyberxz2077/agent-brain-kit/blob/cyberxz2077/feat/publish-agent-brain-kit/templates/Codex/PREFERENCE.md"
click node_agents "https://github.com/cyberxz2077/agent-brain-kit/blob/cyberxz2077/feat/publish-agent-brain-kit/templates/Codex/AGENTS.md"
click node_memory_index "https://github.com/cyberxz2077/agent-brain-kit/blob/cyberxz2077/feat/publish-agent-brain-kit/templates/Codex/MEMORY.md"
click node_flashbacks "https://github.com/cyberxz2077/agent-brain-kit/tree/cyberxz2077/feat/publish-agent-brain-kit/templates/Codex/Memeries/FLASHBACK"
click node_logs "https://github.com/cyberxz2077/agent-brain-kit/tree/cyberxz2077/feat/publish-agent-brain-kit/templates/Codex/Memeries/LOGS"
click node_brain_spec "https://github.com/cyberxz2077/agent-brain-kit/blob/cyberxz2077/feat/publish-agent-brain-kit/templates/Codex/AI-Brain.md"
click node_kimi_setup "https://github.com/cyberxz2077/agent-brain-kit/blob/cyberxz2077/feat/publish-agent-brain-kit/templates/Codex/kimi-code/setup-kimi-code.sh"
click node_kimi_config "https://github.com/cyberxz2077/agent-brain-kit/blob/cyberxz2077/feat/publish-agent-brain-kit/templates/Codex/kimi-code/kimi-conscious.yaml"
click node_kimi_system "https://github.com/cyberxz2077/agent-brain-kit/blob/cyberxz2077/feat/publish-agent-brain-kit/templates/Codex/kimi-code/kimi-conscious-system.md"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_python_cli,node_node_cli,node_shell_installer,node_user toneBlue
class node_soul,node_preference,node_agents,node_memory_index,node_flashbacks,node_logs,node_brain_spec toneAmber
class node_kimi_setup,node_kimi_config,node_kimi_system toneMint
class node_target,node_kimi_cli toneIndigo
```

## Components

### Installers

- [Python installer](https://github.com/cyberxz2077/agent-brain-kit/blob/cyberxz2077/feat/publish-agent-brain-kit/python/agent_memory_bootstrap/cli.py): `python/agent_memory_bootstrap/cli.py`
- [Node installer](https://github.com/cyberxz2077/agent-brain-kit/blob/cyberxz2077/feat/publish-agent-brain-kit/node/bin/ai-brain-init.js): `node/bin/ai-brain-init.js`
- [Shell installer](https://github.com/cyberxz2077/agent-brain-kit/blob/cyberxz2077/feat/publish-agent-brain-kit/install.sh): `install.sh`

### Memory scaffold

- [Stable principles](https://github.com/cyberxz2077/agent-brain-kit/blob/cyberxz2077/feat/publish-agent-brain-kit/templates/Codex/SOUL.md): `templates/Codex/SOUL.md`
- [User preferences](https://github.com/cyberxz2077/agent-brain-kit/blob/cyberxz2077/feat/publish-agent-brain-kit/templates/Codex/PREFERENCE.md): `templates/Codex/PREFERENCE.md`
- [Load and retrieval rules](https://github.com/cyberxz2077/agent-brain-kit/blob/cyberxz2077/feat/publish-agent-brain-kit/templates/Codex/AGENTS.md): `templates/Codex/AGENTS.md`
- [Memory index](https://github.com/cyberxz2077/agent-brain-kit/blob/cyberxz2077/feat/publish-agent-brain-kit/templates/Codex/MEMORY.md): `templates/Codex/MEMORY.md`
- [Flashback summaries](https://github.com/cyberxz2077/agent-brain-kit/tree/cyberxz2077/feat/publish-agent-brain-kit/templates/Codex/Memeries/FLASHBACK): `templates/Codex/Memeries/FLASHBACK`
- [Full context logs](https://github.com/cyberxz2077/agent-brain-kit/tree/cyberxz2077/feat/publish-agent-brain-kit/templates/Codex/Memeries/LOGS): `templates/Codex/Memeries/LOGS`
- [Shareable brain spec](https://github.com/cyberxz2077/agent-brain-kit/blob/cyberxz2077/feat/publish-agent-brain-kit/templates/Codex/AI-Brain.md): `templates/Codex/AI-Brain.md`

### Kimi integration

- [Kimi setup script](https://github.com/cyberxz2077/agent-brain-kit/blob/cyberxz2077/feat/publish-agent-brain-kit/templates/Codex/kimi-code/setup-kimi-code.sh): `templates/Codex/kimi-code/setup-kimi-code.sh`
- [Kimi agent config](https://github.com/cyberxz2077/agent-brain-kit/blob/cyberxz2077/feat/publish-agent-brain-kit/templates/Codex/kimi-code/kimi-conscious.yaml): `templates/Codex/kimi-code/kimi-conscious.yaml`
- [Kimi system prompt](https://github.com/cyberxz2077/agent-brain-kit/blob/cyberxz2077/feat/publish-agent-brain-kit/templates/Codex/kimi-code/kimi-conscious-system.md): `templates/Codex/kimi-code/kimi-conscious-system.md`

### Other components

- **CLI user**
- **Installed scaffold**
- **Kimi Code CLI**

## Connections

- CLI user → Python installer: runs
- CLI user → Node installer: runs
- CLI user → Shell installer: runs
- Python installer → Stable principles: copies templates
- Python installer → User preferences: copies templates
- Python installer → Load and retrieval rules: copies templates
- Python installer → Memory index: copies templates
- Python installer → Flashback summaries: copies templates
- Python installer → Full context logs: copies templates
- Python installer → Shareable brain spec: copies templates
- Python installer → Installed scaffold: writes scaffold
- Node installer → Stable principles: copies templates
- Node installer → User preferences: copies templates
- Node installer → Load and retrieval rules: copies templates
- Node installer → Memory index: copies templates
- Node installer → Flashback summaries: copies templates
- Node installer → Full context logs: copies templates
- Node installer → Shareable brain spec: copies templates
- Node installer → Kimi agent config: copies templates
- Node installer → Kimi system prompt: copies templates
- Node installer → Installed scaffold: writes scaffold
- Shell installer → Installed scaffold: installs scaffold
- CLI user → Kimi setup script: runs optionally
- Kimi setup script → Kimi agent config: configures CLI
- Kimi Code CLI → Kimi agent config: loads agent config
- Kimi agent config → Stable principles: loads principles
- Kimi agent config → User preferences: loads preferences
- Kimi agent config → Memory index: loads memory map