~/.codebuddy/
├── settings.json              # User-level global configuration
├── settings.local.json        # Local personal preferences (not shared)
├── CODEBUDDY.md               # User-level memory file
├── mcp.json                   # Global MCP server configuration
├── statusline-command.sh      # Custom status line script (optional)
│
├── agents/                    # User-level custom subagents (available in all projects)
├── rules/                     # User-level rule files (available in all projects)
├── skills/                    # User-level skills (available in all projects)
│
├── projects/                  # Runtime data for sessions and subagents of each project
├── sessions/                  # Session data
├── plans/                     # Plan files generated in plan mode
│
├── logs/                      # Runtime logs
├── traces/                    # Execution trace data (OpenTelemetry)
├── file-history/              # File change history
├── history.jsonl              # Conversation history
├── blobs/                     # Binary resources (images, screenshots, etc.)
├── tasks/                     # Task tracking data
├── teams/                     # Runtime data for Agent teams
├── shell-snapshots/           # Bash sandbox snapshots
│
├── plugins/                   # Installed plugins
├── local_storage/             # CLI key-value persistent storage
├── channels/                  # Channel configurations (WeChat, etc.)
│
├── computer-use/              # Computer Use feature records
├── debug/                     # Debug information
└── usage-data/                # Usage statistics

{
  "language": "Simplified Chinese",
  "model": "gpt-5",
  "reasoningEffort": "high",
  "permissions": {
    "defaultMode": "default",
    "allow": ["Bash(git:*)"],
    "deny": ["Read(./.env)", "Read(./secrets/**)"]
  },
  "env": {
    "NODE_ENV": "development"
  },
  "memory": {
    "autoMemoryEnabled": true,
    "typedMemory": true
  },
  "trustedDirectories": ["~/workspace/myproject"]
}

## Tool Preferences
- Use pnpm instead of npm
- Prefer a functional programming style

## Code Style
- Use 2-space indentation

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"]
    }
  }
}

~/.codebuddy/agents/
├── code-reviewer.md      # Code review agent
└── translator.md         # Translation agent

---
name: code-reviewer
description: Code review expert. Use proactively after writing code.
tools: Read, Grep, Glob, Bash
model: inherit
---

You are a senior code reviewer, focusing on code quality, security, and practical tutorials...

~/.codebuddy/rules/
├── preferences.md        # Personal coding preferences
└── workflows.md          # Common workflow standards

---
alwaysApply: false
paths: src/**/*.ts
---

# TypeScript Standards

- Prefer `interface` over `type`.
- Do not use `any`.

~/.codebuddy/skills/
└── pdf/
    └── SKILL.md

.codebuddy/
├── settings.json              # Shared project configuration
├── settings.local.json        # Local personal configuration (automatically ignored by .gitignore)
├── CODEBUDDY.md               # Project-level memory file
│
├── agents/                    # Project-level custom subagents
├── rules/                     # Project-level rule files
├── skills/                    # Project-level skills
├── commands/                  # Custom slash commands

{
  "permissions": {
    "allow": ["Read", "Edit", "Bash(git:*)", "Bash(npm:*)"],
    "deny": ["Read(./.env)", "Read(./secrets/**)"]
  },
  "enabledPlugins": {
    "pr-review-toolkit@company-tools": true
  },
  "extraKnownMarketplaces": {
    "company-tools": {
      "source": {
        "source": "github",
        "repo": "myorg/codebuddy-plugins"
      }
    }
  }
}

# Project Description

This project is a TypeScript monorepo (Yarn workspaces).

## Common Commands

- `yarn build` — Build all packages
- `yarn test` — Run all tests

## Architecture Conventions

- Use the CellJS dependency injection framework
- Place protocol definitions in `*-protocol.ts` files

.codebuddy/agents/
├── blog-translator.md     # Blog translation agent
└── docs-reviewer.md       # Documentation review agent

.codebuddy/rules/
├── code-style.md          # Code style conventions
├── testing.md             # Testing standards
├── security.md            # Security requirements
└── frontend/
    ├── react.md           # React component conventions
    └── styles.md          # Style conventions

.codebuddy/skills/
├── case-executor/
│   ├── SKILL.md           # Skill definition
│   ├── scripts/           # Helper scripts
│   └── references/        # Reference materials
└── cnb-api/
    └── SKILL.md

---
name: case-executor
description: Execute JSON test cases and generate a report
allowed-tools: Read, Write, Bash
---

You are a test execution expert responsible for running UI test cases in JSON format...

.codebuddy/commands/
├── deploy.md              # /deploy command
├── team/
│   ├── issue-start.md     # /team:issue-start command
│   └── create-issue.md    # /team:create-issue command
└── openspec/
    └── propose.md         # /openspec:propose command

---
description: Create a new Issue
argument-hint: "<description> ; <type> ; <product>"
allowed-tools: Bash 
---

Create an Issue based on the following description: $ARGUMENTS

Command line parameters (highest priority)
    ↓
.codebuddy/settings.local.json (project-local, not committed to version control)
    ↓
.codebuddy/settings.json (project-shared, team-wide)
    ↓
~/.codebuddy/settings.json (user-global, personal preferences)
    ↓
Built-in product default configuration (lowest priority)

1. User-level memory: ~/.codebuddy/CODEBUDDY.md
2. User-level rules: ~/.codebuddy/rules/*.md (recursive)
3. Project-level memory: CODEBUDDY.md (searched recursively upward from the cwd)
4. Project-level rules: .codebuddy/rules/*.md (cwd only, not upward)
5. Project-local memory: CODEBUDDY.local.md
6. Subdirectory memory: The tool dynamically loads the CODEBUDDY.md file in a subdirectory when operating on files in that subdirectory.