feat: add everything-claude-code ECC bundle (.claude/commands/add-or-update-ecc-command-doc.md)

feat: add everything-claude-code ECC bundle (.claude/commands/feature-development.md)
feat: add everything-claude-code ECC bundle (.claude/commands/database-migration.md)
2026-03-30 13:43:26 +08:00 · 2026-03-24 10:44:29 +00:00 · 2026-03-24 10:44:28 +00:00 · 2026-03-24 10:44:27 +00:00 · 2026-03-24 10:44:26 +00:00 · 2026-03-24 10:44:25 +00:00
28 changed files with 3892 additions and 345 deletions
--- a/.agents/skills/everything-claude-code/SKILL.md
+++ b/.agents/skills/everything-claude-code/SKILL.md
@@ -5,7 +5,7 @@ description: Development conventions and patterns for everything-claude-code. Ja

 # Everything Claude Code Conventions

-> Generated from [affaan-m/everything-claude-code](https://github.com/affaan-m/everything-claude-code) on 2026-03-20
+> Generated from [affaan-m/everything-claude-code](https://github.com/affaan-m/everything-claude-code) on 2026-03-24

 ## Overview

@@ -33,14 +33,14 @@ Follow these commit message conventions based on 500 analyzed commits.

 ### Prefixes Used

- `fix`
- `test`
 - `feat`
+- `fix`
 - `docs`
+- `test`

 ### Message Guidelines

- Average message length: ~65 characters
+- Average message length: ~62 characters
 - Keep first line concise and descriptive
 - Use imperative mood ("Add feature" not "Added feature")

@@ -48,49 +48,49 @@ Follow these commit message conventions based on 500 analyzed commits.
 *Commit message example*

 ```text
-feat(rules): add C# language support
+feat: add everything-claude-code ECC bundle (.claude/commands/add-or-update-skill.md)
 ```

 *Commit message example*

 ```text
-chore(deps-dev): bump flatted (#675)
+perf(hooks): move post-edit-format and post-edit-typecheck to strict-only (#757)
 ```

 *Commit message example*

 ```text
-fix: auto-detect ECC root from plugin cache when CLAUDE_PLUGIN_ROOT is unset (#547) (#691)
+fix: safe Codex config sync — merge AGENTS.md + add-only MCP servers (#723)
 ```

 *Commit message example*

 ```text
-docs: add Antigravity setup and usage guide (#552)
+docs(zh-CN): translate code block(plain text) (#753)
 ```

 *Commit message example*

 ```text
-merge: PR #529 — feat(skills): add documentation-lookup, bun-runtime, nextjs-turbopack; feat(agents): add rust-reviewer
+security: remove supply chain risks, external promotions, and unauthorized credits
 ```

 *Commit message example*

 ```text
-Revert "Add Kiro IDE support (.kiro/) (#548)"
+feat: add everything-claude-code ECC bundle (.claude/commands/feature-development.md)
 ```

 *Commit message example*

 ```text
-Add Kiro IDE support (.kiro/) (#548)
+feat: add everything-claude-code ECC bundle (.claude/commands/database-migration.md)
 ```

 *Commit message example*

 ```text
-feat: add block-no-verify hook for Claude Code and Cursor (#649)
+feat: add everything-claude-code ECC bundle (.claude/enterprise/controls.md)
 ```

 ## Architecture
@@ -196,21 +196,20 @@ Database schema changes with migration files
 3. Generate/update types

 **Files typically involved**:
- `**/schema.*`
 - `migrations/*`

 **Example commit sequence**:
 ```
-feat: implement --with/--without selective install flags (#679)
-fix: sync catalog counts with filesystem (27 agents, 113 skills, 58 commands) (#693)
-feat(rules): add Rust language rules (rebased #660) (#686)
+Add Turkish (tr) docs and update README (#744)
+docs(zh-CN): translate code block(plain text) (#753)
+fix(install): add rust, cpp, csharp to legacy language alias map (#747)
 ```

 ### Feature Development

 Standard feature implementation workflow

-**Frequency**: ~22 times per month
+**Frequency**: ~26 times per month

 **Steps**:
 1. Add feature implementation
@@ -219,204 +218,130 @@ Standard feature implementation workflow

 **Files typically involved**:
 - `manifests/*`
- `schemas/*`
 - `**/*.test.*`
 - `**/api/**`

 **Example commit sequence**:
 ```
-feat(skills): add documentation-lookup, bun-runtime, nextjs-turbopack; feat(agents): add rust-reviewer
-docs(skills): align documentation-lookup with CONTRIBUTING template; add cross-harness (Codex/Cursor) skill copies
-fix: address PR review — skill template (When to use, How it works, Examples), bun.lock, next build note, rust-reviewer CI note, doc-lookup privacy/uncertainty
+Merge pull request #736 from pvgomes/docs/add-brazilian-portuguese-translation
+fix: bump plugin.json and marketplace.json to v1.9.0
+Add Turkish (tr) docs and update README (#744)
 ```

-### Add Language Rules
+### Add Or Update Ecc Command Doc

-Adds a new programming language to the rules system, including coding style, hooks, patterns, security, and testing guidelines.
-
-**Frequency**: ~2 times per month
-
-**Steps**:
-1. Create a new directory under rules/{language}/
-2. Add coding-style.md, hooks.md, patterns.md, security.md, and testing.md files with language-specific content
-3. Optionally reference or link to related skills
-
-**Files typically involved**:
- `rules/*/coding-style.md`
- `rules/*/hooks.md`
- `rules/*/patterns.md`
- `rules/*/security.md`
- `rules/*/testing.md`
-
-**Example commit sequence**:
-```
-Create a new directory under rules/{language}/
-Add coding-style.md, hooks.md, patterns.md, security.md, and testing.md files with language-specific content
-Optionally reference or link to related skills
-```
-
-### Add New Skill
-
-Adds a new skill to the system, documenting its workflow, triggers, and usage, often with supporting scripts.
-
-**Frequency**: ~4 times per month
-
-**Steps**:
-1. Create a new directory under skills/{skill-name}/
-2. Add SKILL.md with documentation (When to Use, How It Works, Examples, etc.)
-3. Optionally add scripts or supporting files under skills/{skill-name}/scripts/
-4. Address review feedback and iterate on documentation
-
-**Files typically involved**:
- `skills/*/SKILL.md`
- `skills/*/scripts/*.sh`
- `skills/*/scripts/*.js`
-
-**Example commit sequence**:
-```
-Create a new directory under skills/{skill-name}/
-Add SKILL.md with documentation (When to Use, How It Works, Examples, etc.)
-Optionally add scripts or supporting files under skills/{skill-name}/scripts/
-Address review feedback and iterate on documentation
-```
-
-### Add New Agent
-
-Adds a new agent to the system for code review, build resolution, or other automated tasks.
-
-**Frequency**: ~2 times per month
-
-**Steps**:
-1. Create a new agent markdown file under agents/{agent-name}.md
-2. Register the agent in AGENTS.md
-3. Optionally update README.md and docs/COMMAND-AGENT-MAP.md
-
-**Files typically involved**:
- `agents/*.md`
- `AGENTS.md`
- `README.md`
- `docs/COMMAND-AGENT-MAP.md`
-
-**Example commit sequence**:
-```
-Create a new agent markdown file under agents/{agent-name}.md
-Register the agent in AGENTS.md
-Optionally update README.md and docs/COMMAND-AGENT-MAP.md
-```
-
-### Add New Command
-
-Adds a new command to the system, often paired with a backing skill.
-
-**Frequency**: ~1 times per month
-
-**Steps**:
-1. Create a new markdown file under commands/{command-name}.md
-2. Optionally add or update a backing skill under skills/{skill-name}/SKILL.md
-
-**Files typically involved**:
- `commands/*.md`
- `skills/*/SKILL.md`
-
-**Example commit sequence**:
-```
-Create a new markdown file under commands/{command-name}.md
-Optionally add or update a backing skill under skills/{skill-name}/SKILL.md
-```
-
-### Sync Catalog Counts
-
-Synchronizes the documented counts of agents, skills, and commands in AGENTS.md and README.md with the actual repository state.
+Adds or updates documentation for an ECC command, typically as a Markdown file under .claude/commands.

 **Frequency**: ~3 times per month

 **Steps**:
-1. Update agent, skill, and command counts in AGENTS.md
-2. Update the same counts in README.md (quick-start, comparison table, etc.)
-3. Optionally update other documentation files
+1. Create or update a Markdown file in .claude/commands/ describing the command.
+2. Optionally, update related documentation elsewhere.

 **Files typically involved**:
- `AGENTS.md`
- `README.md`
+- `.claude/commands/*.md`

 **Example commit sequence**:
 ```
-Update agent, skill, and command counts in AGENTS.md
-Update the same counts in README.md (quick-start, comparison table, etc.)
-Optionally update other documentation files
+Create or update a Markdown file in .claude/commands/ describing the command.
+Optionally, update related documentation elsewhere.
 ```

-### Add Cross Harness Skill Copies
+### Add Or Update Skill Doc

-Adds skill copies for different agent harnesses (e.g., Codex, Cursor, Antigravity) to ensure compatibility across platforms.
+Adds or updates documentation for a skill, typically as SKILL.md under a skill directory.
+
+**Frequency**: ~3 times per month
+
+**Steps**:
+1. Create or update SKILL.md in the relevant skill directory (e.g., skills/skill-name/SKILL.md).
+2. Optionally, update related documentation or diagrams.
+
+**Files typically involved**:
+- `skills/*/SKILL.md`
+- `.agents/skills/*/SKILL.md`
+- `.claude/skills/*/SKILL.md`
+
+**Example commit sequence**:
+```
+Create or update SKILL.md in the relevant skill directory (e.g., skills/skill-name/SKILL.md).
+Optionally, update related documentation or diagrams.
+```
+
+### Add Or Update Localization Docs
+
+Adds or updates localized documentation for agents, commands, skills, and guides in a new or existing language.

 **Frequency**: ~2 times per month

 **Steps**:
-1. Copy or adapt SKILL.md to .agents/skills/{skill}/SKILL.md and/or .cursor/skills/{skill}/SKILL.md
-2. Optionally add harness-specific openai.yaml or config files
-3. Address review feedback to align with CONTRIBUTING template
+1. Add or update multiple Markdown files under docs/<lang>/ for agents, commands, skills, rules, and guides.
+2. Update README.md to reflect supported languages.

 **Files typically involved**:
- `.agents/skills/*/SKILL.md`
- `.cursor/skills/*/SKILL.md`
- `.agents/skills/*/agents/openai.yaml`
+- `docs/*/README.md`
+- `docs/*/agents/*.md`
+- `docs/*/commands/*.md`
+- `docs/*/skills/*/SKILL.md`
+- `docs/*/rules/**/*.md`

 **Example commit sequence**:
 ```
-Copy or adapt SKILL.md to .agents/skills/{skill}/SKILL.md and/or .cursor/skills/{skill}/SKILL.md
-Optionally add harness-specific openai.yaml or config files
-Address review feedback to align with CONTRIBUTING template
+Add or update multiple Markdown files under docs/<lang>/ for agents, commands, skills, rules, and guides.
+Update README.md to reflect supported languages.
 ```

-### Add Or Update Hook
+### Add Or Update Team Or Identity Config

-Adds or updates git or bash hooks to enforce workflow, quality, or security policies.
+Adds or updates team configuration or identity files for ECC.

-**Frequency**: ~1 times per month
+**Frequency**: ~2 times per month

 **Steps**:
-1. Add or update hook scripts in hooks/ or scripts/hooks/
-2. Register the hook in hooks/hooks.json or similar config
-3. Optionally add or update tests in tests/hooks/
+1. Create or update .claude/team/everything-claude-code-team-config.json or .claude/identity.json.

 **Files typically involved**:
- `hooks/*.hook`
- `hooks/hooks.json`
- `scripts/hooks/*.js`
- `tests/hooks/*.test.js`
- `.cursor/hooks.json`
+- `.claude/team/everything-claude-code-team-config.json`
+- `.claude/identity.json`

 **Example commit sequence**:
 ```
-Add or update hook scripts in hooks/ or scripts/hooks/
-Register the hook in hooks/hooks.json or similar config
-Optionally add or update tests in tests/hooks/
+Create or update .claude/team/everything-claude-code-team-config.json or .claude/identity.json.
 ```

-### Address Review Feedback
+### Add Or Update Ecc Tools Config

-Addresses code review feedback by updating documentation, scripts, or configuration for clarity, correctness, or convention alignment.
+Adds or updates the ECC tools configuration file.

-**Frequency**: ~4 times per month
+**Frequency**: ~2 times per month

 **Steps**:
-1. Edit SKILL.md, agent, or command files to address reviewer comments
-2. Update examples, headings, or configuration as requested
-3. Iterate until all review feedback is resolved
+1. Create or update .claude/ecc-tools.json.

 **Files typically involved**:
- `skills/*/SKILL.md`
- `agents/*.md`
- `commands/*.md`
- `.agents/skills/*/SKILL.md`
- `.cursor/skills/*/SKILL.md`
+- `.claude/ecc-tools.json`

 **Example commit sequence**:
 ```
-Edit SKILL.md, agent, or command files to address reviewer comments
-Update examples, headings, or configuration as requested
-Iterate until all review feedback is resolved
+Create or update .claude/ecc-tools.json.
+```
+
+### Add Or Update Agent Config
+
+Adds or updates agent configuration TOML files for Codex or ECC agents.
+
+**Frequency**: ~2 times per month
+
+**Steps**:
+1. Create or update .codex/agents/*.toml or .agents/skills/*/agents/*.yaml.
+
+**Files typically involved**:
+- `.codex/agents/*.toml`
+- `.agents/skills/*/agents/*.yaml`
+
+**Example commit sequence**:
+```
+Create or update .codex/agents/*.toml or .agents/skills/*/agents/*.yaml.
 ```


--- a/.claude/commands/add-or-update-ecc-command-doc.md
+++ b/.claude/commands/add-or-update-ecc-command-doc.md
@@ -0,0 +1,34 @@
+---
+name: add-or-update-ecc-command-doc
+description: Workflow command scaffold for add-or-update-ecc-command-doc in everything-claude-code.
+allowed_tools: ["Bash", "Read", "Write", "Grep", "Glob"]
+---
+
+# /add-or-update-ecc-command-doc
+
+Use this workflow when working on **add-or-update-ecc-command-doc** in `everything-claude-code`.
+
+## Goal
+
+Adds or updates documentation for an ECC command, typically as a Markdown file under .claude/commands.
+
+## Common Files
+
+- `.claude/commands/*.md`
+
+## Suggested Sequence
+
+1. Understand the current state and failure mode before editing.
+2. Make the smallest coherent change that satisfies the workflow goal.
+3. Run the most relevant verification for touched files.
+4. Summarize what changed and what still needs review.
+
+## Typical Commit Signals
+
+- Create or update a Markdown file in .claude/commands/ describing the command.
+- Optionally, update related documentation elsewhere.
+
+## Notes
+
+- Treat this as a scaffold, not a hard-coded script.
+- Update the command if the workflow evolves materially.
--- a/.claude/commands/add-or-update-skill-documentation.md
+++ b/.claude/commands/add-or-update-skill-documentation.md
@@ -0,0 +1,38 @@
+---
+name: add-or-update-skill-documentation
+description: Workflow command scaffold for add-or-update-skill-documentation in everything-claude-code.
+allowed_tools: ["Bash", "Read", "Write", "Grep", "Glob"]
+---
+
+# /add-or-update-skill-documentation
+
+Use this workflow when working on **add-or-update-skill-documentation** in `everything-claude-code`.
+
+## Goal
+
+Adds a new skill or updates documentation for an existing skill. Typically involves creating or modifying SKILL.md files under skills/ or docs/xx/skills/ directories.
+
+## Common Files
+
+- `skills/*/SKILL.md`
+- `docs/*/skills/*/SKILL.md`
+- `AGENTS.md`
+- `README.md`
+
+## Suggested Sequence
+
+1. Understand the current state and failure mode before editing.
+2. Make the smallest coherent change that satisfies the workflow goal.
+3. Run the most relevant verification for touched files.
+4. Summarize what changed and what still needs review.
+
+## Typical Commit Signals
+
+- Create or update SKILL.md under skills/<skill-name>/ or docs/<lang>/skills/<skill-name>/
+- Optionally update AGENTS.md or README.md to reflect new skill count or catalog
+- Commit with message referencing the skill and a summary of changes
+
+## Notes
+
+- Treat this as a scaffold, not a hard-coded script.
+- Update the command if the workflow evolves materially.
--- a/.claude/commands/add-or-update-skill.md
+++ b/.claude/commands/add-or-update-skill.md
@@ -0,0 +1,36 @@
+---
+name: add-or-update-skill
+description: Workflow command scaffold for add-or-update-skill in everything-claude-code.
+allowed_tools: ["Bash", "Read", "Write", "Grep", "Glob"]
+---
+
+# /add-or-update-skill
+
+Use this workflow when working on **add-or-update-skill** in `everything-claude-code`.
+
+## Goal
+
+Adds a new skill or updates an existing skill, including documentation and configuration.
+
+## Common Files
+
+- `skills/*/SKILL.md`
+- `docs/zh-CN/skills/*/SKILL.md`
+- `docs/tr/skills/*/SKILL.md`
+
+## Suggested Sequence
+
+1. Understand the current state and failure mode before editing.
+2. Make the smallest coherent change that satisfies the workflow goal.
+3. Run the most relevant verification for touched files.
+4. Summarize what changed and what still needs review.
+
+## Typical Commit Signals
+
+- Create or update SKILL.md in the appropriate skills/ directory
+- Optionally update related documentation or integration files
+
+## Notes
+
+- Treat this as a scaffold, not a hard-coded script.
+- Update the command if the workflow evolves materially.
--- a/.claude/commands/database-migration.md
+++ b/.claude/commands/database-migration.md
@@ -14,7 +14,6 @@ Database schema changes with migration files

 ## Common Files

- `**/schema.*`
 - `migrations/*`

 ## Suggested Sequence
--- a/.claude/commands/feature-development.md
+++ b/.claude/commands/feature-development.md
@@ -15,7 +15,6 @@ Standard feature implementation workflow
 ## Common Files

 - `manifests/*`
- `schemas/*`
 - `**/*.test.*`
 - `**/api/**`

--- a/.claude/ecc-tools.json
+++ b/.claude/ecc-tools.json
@@ -2,7 +2,7 @@
  "version": "1.3",
  "schemaVersion": "1.0",
  "generatedBy": "ecc-tools",
-  "generatedAt": "2026-03-20T12:07:36.496Z",
+  "generatedAt": "2026-03-24T10:43:58.912Z",
  "repo": "https://github.com/affaan-m/everything-claude-code",
  "profiles": {
    "requested": "full",
@@ -150,7 +150,7 @@
    ".claude/enterprise/controls.md",
    ".claude/commands/database-migration.md",
    ".claude/commands/feature-development.md",
-    ".claude/commands/add-language-rules.md"
+    ".claude/commands/add-or-update-ecc-command-doc.md"
  ],
  "packageFiles": {
    "runtime-core": [
@@ -180,7 +180,7 @@
    "workflow-pack": [
      ".claude/commands/database-migration.md",
      ".claude/commands/feature-development.md",
-      ".claude/commands/add-language-rules.md"
+      ".claude/commands/add-or-update-ecc-command-doc.md"
    ]
  },
  "moduleFiles": {
@@ -211,7 +211,7 @@
    "workflow-pack": [
      ".claude/commands/database-migration.md",
      ".claude/commands/feature-development.md",
-      ".claude/commands/add-language-rules.md"
+      ".claude/commands/add-or-update-ecc-command-doc.md"
    ]
  },
  "files": [
@@ -297,8 +297,8 @@
    },
    {
      "moduleId": "workflow-pack",
-      "path": ".claude/commands/add-language-rules.md",
-      "description": "Workflow command scaffold for add-language-rules."
+      "path": ".claude/commands/add-or-update-ecc-command-doc.md",
+      "description": "Workflow command scaffold for add-or-update-ecc-command-doc."
    }
  ],
  "workflows": [
@@ -311,8 +311,8 @@
      "path": ".claude/commands/feature-development.md"
    },
    {
-      "command": "add-language-rules",
-      "path": ".claude/commands/add-language-rules.md"
+      "command": "add-or-update-ecc-command-doc",
+      "path": ".claude/commands/add-or-update-ecc-command-doc.md"
    }
  ],
  "adapters": {
@@ -322,7 +322,7 @@
      "commandPaths": [
        ".claude/commands/database-migration.md",
        ".claude/commands/feature-development.md",
-        ".claude/commands/add-language-rules.md"
+        ".claude/commands/add-or-update-ecc-command-doc.md"
      ]
    },
    "codex": {
--- a/.claude/identity.json
+++ b/.claude/identity.json
@@ -10,5 +10,5 @@
    "javascript"
  ],
  "suggestedBy": "ecc-tools-repo-analysis",
-  "createdAt": "2026-03-20T12:07:57.119Z"
+  "createdAt": "2026-03-24T10:44:13.997Z"
 }
--- a/.claude/research/everything-claude-code-research-playbook.md
+++ b/.claude/research/everything-claude-code-research-playbook.md
@@ -18,4 +18,4 @@ Use this when the task is documentation-heavy, source-sensitive, or requires bro

 - Primary language: JavaScript
 - Framework: Not detected
- Workflows detected: 10
+- Workflows detected: 8
--- a/.claude/rules/everything-claude-code-guardrails.md
+++ b/.claude/rules/everything-claude-code-guardrails.md
@@ -4,7 +4,7 @@ Generated by ECC Tools from repository history. Review before treating it as a h

 ## Commit Workflow

- Prefer `conventional` commit messaging with prefixes such as fix, test, feat, docs.
+- Prefer `conventional` commit messaging with prefixes such as feat, fix, docs, test.
 - Keep new changes aligned with the existing pull-request and review flow already present in the repo.

 ## Architecture
@@ -26,7 +26,7 @@ Generated by ECC Tools from repository history. Review before treating it as a h

 - database-migration: Database schema changes with migration files
 - feature-development: Standard feature implementation workflow
- add-language-rules: Adds a new programming language to the rules system, including coding style, hooks, patterns, security, and testing guidelines.
+- add-or-update-ecc-command-doc: Adds or updates documentation for an ECC command, typically as a Markdown file under .claude/commands.

 ## Review Reminder

--- a/.claude/skills/everything-claude-code/SKILL.md
+++ b/.claude/skills/everything-claude-code/SKILL.md
@@ -5,7 +5,7 @@ description: Development conventions and patterns for everything-claude-code. Ja

 # Everything Claude Code Conventions

-> Generated from [affaan-m/everything-claude-code](https://github.com/affaan-m/everything-claude-code) on 2026-03-20
+> Generated from [affaan-m/everything-claude-code](https://github.com/affaan-m/everything-claude-code) on 2026-03-24

 ## Overview

@@ -33,14 +33,14 @@ Follow these commit message conventions based on 500 analyzed commits.

 ### Prefixes Used

- `fix`
- `test`
 - `feat`
+- `fix`
 - `docs`
+- `test`

 ### Message Guidelines

- Average message length: ~65 characters
+- Average message length: ~62 characters
 - Keep first line concise and descriptive
 - Use imperative mood ("Add feature" not "Added feature")

@@ -48,49 +48,49 @@ Follow these commit message conventions based on 500 analyzed commits.
 *Commit message example*

 ```text
-feat(rules): add C# language support
+feat: add everything-claude-code ECC bundle (.claude/commands/add-or-update-skill.md)
 ```

 *Commit message example*

 ```text
-chore(deps-dev): bump flatted (#675)
+perf(hooks): move post-edit-format and post-edit-typecheck to strict-only (#757)
 ```

 *Commit message example*

 ```text
-fix: auto-detect ECC root from plugin cache when CLAUDE_PLUGIN_ROOT is unset (#547) (#691)
+fix: safe Codex config sync — merge AGENTS.md + add-only MCP servers (#723)
 ```

 *Commit message example*

 ```text
-docs: add Antigravity setup and usage guide (#552)
+docs(zh-CN): translate code block(plain text) (#753)
 ```

 *Commit message example*

 ```text
-merge: PR #529 — feat(skills): add documentation-lookup, bun-runtime, nextjs-turbopack; feat(agents): add rust-reviewer
+security: remove supply chain risks, external promotions, and unauthorized credits
 ```

 *Commit message example*

 ```text
-Revert "Add Kiro IDE support (.kiro/) (#548)"
+feat: add everything-claude-code ECC bundle (.claude/commands/feature-development.md)
 ```

 *Commit message example*

 ```text
-Add Kiro IDE support (.kiro/) (#548)
+feat: add everything-claude-code ECC bundle (.claude/commands/database-migration.md)
 ```

 *Commit message example*

 ```text
-feat: add block-no-verify hook for Claude Code and Cursor (#649)
+feat: add everything-claude-code ECC bundle (.claude/enterprise/controls.md)
 ```

 ## Architecture
@@ -196,21 +196,20 @@ Database schema changes with migration files
 3. Generate/update types

 **Files typically involved**:
- `**/schema.*`
 - `migrations/*`

 **Example commit sequence**:
 ```
-feat: implement --with/--without selective install flags (#679)
-fix: sync catalog counts with filesystem (27 agents, 113 skills, 58 commands) (#693)
-feat(rules): add Rust language rules (rebased #660) (#686)
+Add Turkish (tr) docs and update README (#744)
+docs(zh-CN): translate code block(plain text) (#753)
+fix(install): add rust, cpp, csharp to legacy language alias map (#747)
 ```

 ### Feature Development

 Standard feature implementation workflow

-**Frequency**: ~22 times per month
+**Frequency**: ~26 times per month

 **Steps**:
 1. Add feature implementation
@@ -219,204 +218,130 @@ Standard feature implementation workflow

 **Files typically involved**:
 - `manifests/*`
- `schemas/*`
 - `**/*.test.*`
 - `**/api/**`

 **Example commit sequence**:
 ```
-feat(skills): add documentation-lookup, bun-runtime, nextjs-turbopack; feat(agents): add rust-reviewer
-docs(skills): align documentation-lookup with CONTRIBUTING template; add cross-harness (Codex/Cursor) skill copies
-fix: address PR review — skill template (When to use, How it works, Examples), bun.lock, next build note, rust-reviewer CI note, doc-lookup privacy/uncertainty
+Merge pull request #736 from pvgomes/docs/add-brazilian-portuguese-translation
+fix: bump plugin.json and marketplace.json to v1.9.0
+Add Turkish (tr) docs and update README (#744)
 ```

-### Add Language Rules
+### Add Or Update Ecc Command Doc

-Adds a new programming language to the rules system, including coding style, hooks, patterns, security, and testing guidelines.
-
-**Frequency**: ~2 times per month
-
-**Steps**:
-1. Create a new directory under rules/{language}/
-2. Add coding-style.md, hooks.md, patterns.md, security.md, and testing.md files with language-specific content
-3. Optionally reference or link to related skills
-
-**Files typically involved**:
- `rules/*/coding-style.md`
- `rules/*/hooks.md`
- `rules/*/patterns.md`
- `rules/*/security.md`
- `rules/*/testing.md`
-
-**Example commit sequence**:
-```
-Create a new directory under rules/{language}/
-Add coding-style.md, hooks.md, patterns.md, security.md, and testing.md files with language-specific content
-Optionally reference or link to related skills
-```
-
-### Add New Skill
-
-Adds a new skill to the system, documenting its workflow, triggers, and usage, often with supporting scripts.
-
-**Frequency**: ~4 times per month
-
-**Steps**:
-1. Create a new directory under skills/{skill-name}/
-2. Add SKILL.md with documentation (When to Use, How It Works, Examples, etc.)
-3. Optionally add scripts or supporting files under skills/{skill-name}/scripts/
-4. Address review feedback and iterate on documentation
-
-**Files typically involved**:
- `skills/*/SKILL.md`
- `skills/*/scripts/*.sh`
- `skills/*/scripts/*.js`
-
-**Example commit sequence**:
-```
-Create a new directory under skills/{skill-name}/
-Add SKILL.md with documentation (When to Use, How It Works, Examples, etc.)
-Optionally add scripts or supporting files under skills/{skill-name}/scripts/
-Address review feedback and iterate on documentation
-```
-
-### Add New Agent
-
-Adds a new agent to the system for code review, build resolution, or other automated tasks.
-
-**Frequency**: ~2 times per month
-
-**Steps**:
-1. Create a new agent markdown file under agents/{agent-name}.md
-2. Register the agent in AGENTS.md
-3. Optionally update README.md and docs/COMMAND-AGENT-MAP.md
-
-**Files typically involved**:
- `agents/*.md`
- `AGENTS.md`
- `README.md`
- `docs/COMMAND-AGENT-MAP.md`
-
-**Example commit sequence**:
-```
-Create a new agent markdown file under agents/{agent-name}.md
-Register the agent in AGENTS.md
-Optionally update README.md and docs/COMMAND-AGENT-MAP.md
-```
-
-### Add New Command
-
-Adds a new command to the system, often paired with a backing skill.
-
-**Frequency**: ~1 times per month
-
-**Steps**:
-1. Create a new markdown file under commands/{command-name}.md
-2. Optionally add or update a backing skill under skills/{skill-name}/SKILL.md
-
-**Files typically involved**:
- `commands/*.md`
- `skills/*/SKILL.md`
-
-**Example commit sequence**:
-```
-Create a new markdown file under commands/{command-name}.md
-Optionally add or update a backing skill under skills/{skill-name}/SKILL.md
-```
-
-### Sync Catalog Counts
-
-Synchronizes the documented counts of agents, skills, and commands in AGENTS.md and README.md with the actual repository state.
+Adds or updates documentation for an ECC command, typically as a Markdown file under .claude/commands.

 **Frequency**: ~3 times per month

 **Steps**:
-1. Update agent, skill, and command counts in AGENTS.md
-2. Update the same counts in README.md (quick-start, comparison table, etc.)
-3. Optionally update other documentation files
+1. Create or update a Markdown file in .claude/commands/ describing the command.
+2. Optionally, update related documentation elsewhere.

 **Files typically involved**:
- `AGENTS.md`
- `README.md`
+- `.claude/commands/*.md`

 **Example commit sequence**:
 ```
-Update agent, skill, and command counts in AGENTS.md
-Update the same counts in README.md (quick-start, comparison table, etc.)
-Optionally update other documentation files
+Create or update a Markdown file in .claude/commands/ describing the command.
+Optionally, update related documentation elsewhere.
 ```

-### Add Cross Harness Skill Copies
+### Add Or Update Skill Doc

-Adds skill copies for different agent harnesses (e.g., Codex, Cursor, Antigravity) to ensure compatibility across platforms.
+Adds or updates documentation for a skill, typically as SKILL.md under a skill directory.
+
+**Frequency**: ~3 times per month
+
+**Steps**:
+1. Create or update SKILL.md in the relevant skill directory (e.g., skills/skill-name/SKILL.md).
+2. Optionally, update related documentation or diagrams.
+
+**Files typically involved**:
+- `skills/*/SKILL.md`
+- `.agents/skills/*/SKILL.md`
+- `.claude/skills/*/SKILL.md`
+
+**Example commit sequence**:
+```
+Create or update SKILL.md in the relevant skill directory (e.g., skills/skill-name/SKILL.md).
+Optionally, update related documentation or diagrams.
+```
+
+### Add Or Update Localization Docs
+
+Adds or updates localized documentation for agents, commands, skills, and guides in a new or existing language.

 **Frequency**: ~2 times per month

 **Steps**:
-1. Copy or adapt SKILL.md to .agents/skills/{skill}/SKILL.md and/or .cursor/skills/{skill}/SKILL.md
-2. Optionally add harness-specific openai.yaml or config files
-3. Address review feedback to align with CONTRIBUTING template
+1. Add or update multiple Markdown files under docs/<lang>/ for agents, commands, skills, rules, and guides.
+2. Update README.md to reflect supported languages.

 **Files typically involved**:
- `.agents/skills/*/SKILL.md`
- `.cursor/skills/*/SKILL.md`
- `.agents/skills/*/agents/openai.yaml`
+- `docs/*/README.md`
+- `docs/*/agents/*.md`
+- `docs/*/commands/*.md`
+- `docs/*/skills/*/SKILL.md`
+- `docs/*/rules/**/*.md`

 **Example commit sequence**:
 ```
-Copy or adapt SKILL.md to .agents/skills/{skill}/SKILL.md and/or .cursor/skills/{skill}/SKILL.md
-Optionally add harness-specific openai.yaml or config files
-Address review feedback to align with CONTRIBUTING template
+Add or update multiple Markdown files under docs/<lang>/ for agents, commands, skills, rules, and guides.
+Update README.md to reflect supported languages.
 ```

-### Add Or Update Hook
+### Add Or Update Team Or Identity Config

-Adds or updates git or bash hooks to enforce workflow, quality, or security policies.
+Adds or updates team configuration or identity files for ECC.

-**Frequency**: ~1 times per month
+**Frequency**: ~2 times per month

 **Steps**:
-1. Add or update hook scripts in hooks/ or scripts/hooks/
-2. Register the hook in hooks/hooks.json or similar config
-3. Optionally add or update tests in tests/hooks/
+1. Create or update .claude/team/everything-claude-code-team-config.json or .claude/identity.json.

 **Files typically involved**:
- `hooks/*.hook`
- `hooks/hooks.json`
- `scripts/hooks/*.js`
- `tests/hooks/*.test.js`
- `.cursor/hooks.json`
+- `.claude/team/everything-claude-code-team-config.json`
+- `.claude/identity.json`

 **Example commit sequence**:
 ```
-Add or update hook scripts in hooks/ or scripts/hooks/
-Register the hook in hooks/hooks.json or similar config
-Optionally add or update tests in tests/hooks/
+Create or update .claude/team/everything-claude-code-team-config.json or .claude/identity.json.
 ```

-### Address Review Feedback
+### Add Or Update Ecc Tools Config

-Addresses code review feedback by updating documentation, scripts, or configuration for clarity, correctness, or convention alignment.
+Adds or updates the ECC tools configuration file.

-**Frequency**: ~4 times per month
+**Frequency**: ~2 times per month

 **Steps**:
-1. Edit SKILL.md, agent, or command files to address reviewer comments
-2. Update examples, headings, or configuration as requested
-3. Iterate until all review feedback is resolved
+1. Create or update .claude/ecc-tools.json.

 **Files typically involved**:
- `skills/*/SKILL.md`
- `agents/*.md`
- `commands/*.md`
- `.agents/skills/*/SKILL.md`
- `.cursor/skills/*/SKILL.md`
+- `.claude/ecc-tools.json`

 **Example commit sequence**:
 ```
-Edit SKILL.md, agent, or command files to address reviewer comments
-Update examples, headings, or configuration as requested
-Iterate until all review feedback is resolved
+Create or update .claude/ecc-tools.json.
+```
+
+### Add Or Update Agent Config
+
+Adds or updates agent configuration TOML files for Codex or ECC agents.
+
+**Frequency**: ~2 times per month
+
+**Steps**:
+1. Create or update .codex/agents/*.toml or .agents/skills/*/agents/*.yaml.
+
+**Files typically involved**:
+- `.codex/agents/*.toml`
+- `.agents/skills/*/agents/*.yaml`
+
+**Example commit sequence**:
+```
+Create or update .codex/agents/*.toml or .agents/skills/*/agents/*.yaml.
 ```


--- a/.claude/team/everything-claude-code-team-config.json
+++ b/.claude/team/everything-claude-code-team-config.json
@@ -9,7 +9,7 @@
  "commandFiles": [
    ".claude/commands/database-migration.md",
    ".claude/commands/feature-development.md",
-    ".claude/commands/add-language-rules.md"
+    ".claude/commands/add-or-update-ecc-command-doc.md"
  ],
-  "updatedAt": "2026-03-20T12:07:36.496Z"
+  "updatedAt": "2026-03-24T10:43:58.912Z"
 }
--- a/.gitignore
+++ b/.gitignore
@@ -83,6 +83,9 @@ temp/
 *.bak
 *.backup

+# Rust build artifacts
+ecc2/target/
+
 # Bootstrap pipeline outputs
 # Generated lock files in tool subdirectories
 .opencode/package-lock.json
--- a/ecc2/Cargo.lock
+++ b/ecc2/Cargo.lock
--- a/ecc2/Cargo.toml
+++ b/ecc2/Cargo.toml
@@ -0,0 +1,52 @@
+[package]
+name = "ecc-tui"
+version = "0.1.0"
+edition = "2021"
+description = "ECC 2.0 — Agentic IDE control plane with TUI dashboard"
+license = "MIT"
+authors = ["Affaan Mustafa <me@affaanmustafa.com>"]
+repository = "https://github.com/affaan-m/everything-claude-code"
+
+[dependencies]
+# TUI
+ratatui = "0.29"
+crossterm = "0.28"
+
+# Async runtime
+tokio = { version = "1", features = ["full"] }
+
+# State store
+rusqlite = { version = "0.32", features = ["bundled"] }
+
+# Git integration
+git2 = "0.19"
+
+# Serialization
+serde = { version = "1", features = ["derive"] }
+serde_json = "1"
+toml = "0.8"
+
+# CLI
+clap = { version = "4", features = ["derive"] }
+
+# Logging & tracing
+tracing = "0.1"
+tracing-subscriber = { version = "0.3", features = ["env-filter"] }
+
+# Error handling
+anyhow = "1"
+thiserror = "2"
+
+# Time
+chrono = { version = "0.4", features = ["serde"] }
+
+# UUID for session IDs
+uuid = { version = "1", features = ["v4"] }
+
+# Directory paths
+dirs = "6"
+
+[profile.release]
+lto = true
+codegen-units = 1
+strip = true
--- a/ecc2/src/comms/mod.rs
+++ b/ecc2/src/comms/mod.rs
@@ -0,0 +1,33 @@
+use anyhow::Result;
+use serde::{Deserialize, Serialize};
+
+use crate::session::store::StateStore;
+
+/// Message types for inter-agent communication.
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub enum MessageType {
+    /// Task handoff from one agent to another
+    TaskHandoff { task: String, context: String },
+    /// Agent requesting information from another
+    Query { question: String },
+    /// Response to a query
+    Response { answer: String },
+    /// Notification of completion
+    Completed { summary: String, files_changed: Vec<String> },
+    /// Conflict detected (e.g., two agents editing the same file)
+    Conflict { file: String, description: String },
+}
+
+/// Send a structured message between sessions.
+pub fn send(db: &StateStore, from: &str, to: &str, msg: &MessageType) -> Result<()> {
+    let content = serde_json::to_string(msg)?;
+    let msg_type = match msg {
+        MessageType::TaskHandoff { .. } => "task_handoff",
+        MessageType::Query { .. } => "query",
+        MessageType::Response { .. } => "response",
+        MessageType::Completed { .. } => "completed",
+        MessageType::Conflict { .. } => "conflict",
+    };
+    db.send_message(from, to, &content, msg_type)?;
+    Ok(())
+}
--- a/ecc2/src/config/mod.rs
+++ b/ecc2/src/config/mod.rs
@@ -0,0 +1,91 @@
+use anyhow::Result;
+use serde::{Deserialize, Serialize};
+use std::path::PathBuf;
+
+#[derive(Debug, Clone, Copy, Default, PartialEq, Eq, Serialize, Deserialize)]
+#[serde(rename_all = "snake_case")]
+pub enum PaneLayout {
+    #[default]
+    Horizontal,
+    Vertical,
+    Grid,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize)]
+#[serde(default)]
+pub struct Config {
+    pub db_path: PathBuf,
+    pub worktree_root: PathBuf,
+    pub max_parallel_sessions: usize,
+    pub max_parallel_worktrees: usize,
+    pub session_timeout_secs: u64,
+    pub heartbeat_interval_secs: u64,
+    pub default_agent: String,
+    pub theme: Theme,
+    pub pane_layout: PaneLayout,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub enum Theme {
+    Dark,
+    Light,
+}
+
+impl Default for Config {
+    fn default() -> Self {
+        let home = dirs::home_dir().unwrap_or_else(|| PathBuf::from("."));
+        Self {
+            db_path: home.join(".claude").join("ecc2.db"),
+            worktree_root: PathBuf::from("/tmp/ecc-worktrees"),
+            max_parallel_sessions: 8,
+            max_parallel_worktrees: 6,
+            session_timeout_secs: 3600,
+            heartbeat_interval_secs: 30,
+            default_agent: "claude".to_string(),
+            theme: Theme::Dark,
+            pane_layout: PaneLayout::Horizontal,
+        }
+    }
+}
+
+impl Config {
+    pub fn load() -> Result<Self> {
+        let config_path = dirs::home_dir()
+            .unwrap_or_else(|| PathBuf::from("."))
+            .join(".claude")
+            .join("ecc2.toml");
+
+        if config_path.exists() {
+            let content = std::fs::read_to_string(&config_path)?;
+            let config: Config = toml::from_str(&content)?;
+            Ok(config)
+        } else {
+            Ok(Config::default())
+        }
+    }
+}
+
+#[cfg(test)]
+mod tests {
+    use super::{Config, PaneLayout};
+
+    #[test]
+    fn default_config_uses_horizontal_pane_layout() {
+        assert_eq!(Config::default().pane_layout, PaneLayout::Horizontal);
+    }
+
+    #[test]
+    fn missing_pane_layout_deserializes_to_default() {
+        let cfg: Config = toml::from_str(r#"default_agent = "codex""#).unwrap();
+
+        assert_eq!(cfg.pane_layout, PaneLayout::Horizontal);
+        assert_eq!(cfg.default_agent, "codex");
+    }
+
+    #[test]
+    fn pane_layout_deserializes_from_toml() {
+        let cfg: Config = toml::from_str(r#"pane_layout = "grid""#).unwrap();
+
+        assert_eq!(cfg.pane_layout, PaneLayout::Grid);
+    }
+}
--- a/ecc2/src/main.rs
+++ b/ecc2/src/main.rs
@@ -0,0 +1,94 @@
+mod config;
+mod session;
+mod tui;
+mod worktree;
+mod observability;
+mod comms;
+
+use anyhow::Result;
+use clap::Parser;
+use tracing_subscriber::EnvFilter;
+
+#[derive(Parser, Debug)]
+#[command(name = "ecc", version, about = "ECC 2.0 — Agentic IDE control plane")]
+struct Cli {
+    #[command(subcommand)]
+    command: Option<Commands>,
+}
+
+#[derive(clap::Subcommand, Debug)]
+enum Commands {
+    /// Launch the TUI dashboard
+    Dashboard,
+    /// Start a new agent session
+    Start {
+        /// Task description for the agent
+        #[arg(short, long)]
+        task: String,
+        /// Agent type (claude, codex, custom)
+        #[arg(short, long, default_value = "claude")]
+        agent: String,
+        /// Create a dedicated worktree for this session
+        #[arg(short, long)]
+        worktree: bool,
+    },
+    /// List active sessions
+    Sessions,
+    /// Show session details
+    Status {
+        /// Session ID or alias
+        session_id: Option<String>,
+    },
+    /// Stop a running session
+    Stop {
+        /// Session ID or alias
+        session_id: String,
+    },
+    /// Run as background daemon
+    Daemon,
+}
+
+#[tokio::main]
+async fn main() -> Result<()> {
+    tracing_subscriber::fmt()
+        .with_env_filter(EnvFilter::from_default_env())
+        .init();
+
+    let cli = Cli::parse();
+
+    let cfg = config::Config::load()?;
+    let db = session::store::StateStore::open(&cfg.db_path)?;
+
+    match cli.command {
+        Some(Commands::Dashboard) | None => {
+            tui::app::run(db, cfg).await?;
+        }
+        Some(Commands::Start { task, agent, worktree: use_worktree }) => {
+            let session_id = session::manager::create_session(
+                &db, &cfg, &task, &agent, use_worktree,
+            ).await?;
+            println!("Session started: {session_id}");
+        }
+        Some(Commands::Sessions) => {
+            let sessions = session::manager::list_sessions(&db)?;
+            for s in sessions {
+                println!("{} [{}] {}", s.id, s.state, s.task);
+            }
+        }
+        Some(Commands::Status { session_id }) => {
+            let id = session_id.unwrap_or_else(|| "latest".to_string());
+            let status = session::manager::get_status(&db, &id)?;
+            println!("{status}");
+        }
+        Some(Commands::Stop { session_id }) => {
+            session::manager::stop_session(&db, &session_id).await?;
+            println!("Session stopped: {session_id}");
+        }
+        Some(Commands::Daemon) => {
+            println!("Starting ECC daemon...");
+            session::daemon::run(db, cfg).await?;
+        }
+    }
+
+    Ok(())
+}
--- a/ecc2/src/observability/mod.rs
+++ b/ecc2/src/observability/mod.rs
@@ -0,0 +1,54 @@
+use anyhow::Result;
+use serde::{Deserialize, Serialize};
+
+use crate::session::store::StateStore;
+
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub struct ToolCallEvent {
+    pub session_id: String,
+    pub tool_name: String,
+    pub input_summary: String,
+    pub output_summary: String,
+    pub duration_ms: u64,
+    pub risk_score: f64,
+}
+
+impl ToolCallEvent {
+    /// Compute risk score based on tool type and input patterns.
+    pub fn compute_risk(tool_name: &str, input: &str) -> f64 {
+        let mut score: f64 = 0.0;
+
+        // Destructive tools get higher base risk
+        match tool_name {
+            "Bash" => score += 0.3,
+            "Write" => score += 0.2,
+            "Edit" => score += 0.1,
+            _ => score += 0.05,
+        }
+
+        // Dangerous patterns in bash commands
+        if tool_name == "Bash" {
+            if input.contains("rm -rf") || input.contains("--force") {
+                score += 0.4;
+            }
+            if input.contains("git push") || input.contains("git reset") {
+                score += 0.3;
+            }
+            if input.contains("sudo") || input.contains("chmod 777") {
+                score += 0.5;
+            }
+        }
+
+        score.min(1.0)
+    }
+}
+
+pub fn log_tool_call(db: &StateStore, event: &ToolCallEvent) -> Result<()> {
+    db.send_message(
+        &event.session_id,
+        "observability",
+        &serde_json::to_string(event)?,
+        "tool_call",
+    )?;
+    Ok(())
+}
--- a/ecc2/src/session/daemon.rs
+++ b/ecc2/src/session/daemon.rs
@@ -0,0 +1,46 @@
+use anyhow::Result;
+use std::time::Duration;
+use tokio::time;
+
+use super::store::StateStore;
+use super::SessionState;
+use crate::config::Config;
+
+/// Background daemon that monitors sessions, handles heartbeats,
+/// and cleans up stale resources.
+pub async fn run(db: StateStore, cfg: Config) -> Result<()> {
+    tracing::info!("ECC daemon started");
+
+    let heartbeat_interval = Duration::from_secs(cfg.heartbeat_interval_secs);
+    let timeout = Duration::from_secs(cfg.session_timeout_secs);
+
+    loop {
+        if let Err(e) = check_sessions(&db, timeout) {
+            tracing::error!("Session check failed: {e}");
+        }
+
+        time::sleep(heartbeat_interval).await;
+    }
+}
+
+fn check_sessions(db: &StateStore, timeout: Duration) -> Result<()> {
+    let sessions = db.list_sessions()?;
+
+    for session in sessions {
+        if session.state != SessionState::Running {
+            continue;
+        }
+
+        let elapsed = chrono::Utc::now()
+            .signed_duration_since(session.updated_at)
+            .to_std()
+            .unwrap_or(Duration::ZERO);
+
+        if elapsed > timeout {
+            tracing::warn!("Session {} timed out after {:?}", session.id, elapsed);
+            db.update_state(&session.id, &SessionState::Failed)?;
+        }
+    }
+
+    Ok(())
+}
--- a/ecc2/src/session/manager.rs
+++ b/ecc2/src/session/manager.rs
@@ -0,0 +1,76 @@
+use anyhow::Result;
+use std::fmt;
+
+use super::{Session, SessionMetrics, SessionState};
+use super::store::StateStore;
+use crate::config::Config;
+use crate::worktree;
+
+pub async fn create_session(
+    db: &StateStore,
+    cfg: &Config,
+    task: &str,
+    agent_type: &str,
+    use_worktree: bool,
+) -> Result<String> {
+    let id = uuid::Uuid::new_v4().to_string()[..8].to_string();
+    let now = chrono::Utc::now();
+
+    let wt = if use_worktree {
+        Some(worktree::create_for_session(&id, cfg)?)
+    } else {
+        None
+    };
+
+    let session = Session {
+        id: id.clone(),
+        task: task.to_string(),
+        agent_type: agent_type.to_string(),
+        state: SessionState::Pending,
+        worktree: wt,
+        created_at: now,
+        updated_at: now,
+        metrics: SessionMetrics::default(),
+    };
+
+    db.insert_session(&session)?;
+    Ok(id)
+}
+
+pub fn list_sessions(db: &StateStore) -> Result<Vec<Session>> {
+    db.list_sessions()
+}
+
+pub fn get_status(db: &StateStore, id: &str) -> Result<SessionStatus> {
+    let session = db
+        .get_session(id)?
+        .ok_or_else(|| anyhow::anyhow!("Session not found: {id}"))?;
+    Ok(SessionStatus(session))
+}
+
+pub async fn stop_session(db: &StateStore, id: &str) -> Result<()> {
+    db.update_state(id, &SessionState::Stopped)?;
+    Ok(())
+}
+
+pub struct SessionStatus(Session);
+
+impl fmt::Display for SessionStatus {
+    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
+        let s = &self.0;
+        writeln!(f, "Session: {}", s.id)?;
+        writeln!(f, "Task:    {}", s.task)?;
+        writeln!(f, "Agent:   {}", s.agent_type)?;
+        writeln!(f, "State:   {}", s.state)?;
+        if let Some(ref wt) = s.worktree {
+            writeln!(f, "Branch:  {}", wt.branch)?;
+            writeln!(f, "Worktree: {}", wt.path.display())?;
+        }
+        writeln!(f, "Tokens:  {}", s.metrics.tokens_used)?;
+        writeln!(f, "Tools:   {}", s.metrics.tool_calls)?;
+        writeln!(f, "Files:   {}", s.metrics.files_changed)?;
+        writeln!(f, "Cost:    ${:.4}", s.metrics.cost_usd)?;
+        writeln!(f, "Created: {}", s.created_at)?;
+        write!(f, "Updated: {}", s.updated_at)
+    }
+}
--- a/ecc2/src/session/mod.rs
+++ b/ecc2/src/session/mod.rs
@@ -0,0 +1,59 @@
+pub mod daemon;
+pub mod manager;
+pub mod store;
+
+use chrono::{DateTime, Utc};
+use serde::{Deserialize, Serialize};
+use std::fmt;
+use std::path::PathBuf;
+
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub struct Session {
+    pub id: String,
+    pub task: String,
+    pub agent_type: String,
+    pub state: SessionState,
+    pub worktree: Option<WorktreeInfo>,
+    pub created_at: DateTime<Utc>,
+    pub updated_at: DateTime<Utc>,
+    pub metrics: SessionMetrics,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize, PartialEq)]
+pub enum SessionState {
+    Pending,
+    Running,
+    Idle,
+    Completed,
+    Failed,
+    Stopped,
+}
+
+impl fmt::Display for SessionState {
+    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
+        match self {
+            SessionState::Pending => write!(f, "pending"),
+            SessionState::Running => write!(f, "running"),
+            SessionState::Idle => write!(f, "idle"),
+            SessionState::Completed => write!(f, "completed"),
+            SessionState::Failed => write!(f, "failed"),
+            SessionState::Stopped => write!(f, "stopped"),
+        }
+    }
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub struct WorktreeInfo {
+    pub path: PathBuf,
+    pub branch: String,
+    pub base_branch: String,
+}
+
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+pub struct SessionMetrics {
+    pub tokens_used: u64,
+    pub tool_calls: u64,
+    pub files_changed: u32,
+    pub duration_secs: u64,
+    pub cost_usd: f64,
+}
--- a/ecc2/src/session/store.rs
+++ b/ecc2/src/session/store.rs
@@ -0,0 +1,278 @@
+use anyhow::Result;
+use rusqlite::Connection;
+use std::path::Path;
+
+use super::{Session, SessionMetrics, SessionState};
+use crate::observability::ToolCallEvent;
+
+#[derive(Debug, Clone, PartialEq)]
+pub struct ToolLogEntry {
+    pub tool_name: String,
+    pub input_summary: String,
+    pub output_summary: String,
+    pub duration_ms: u64,
+    pub risk_score: f64,
+    pub timestamp: String,
+}
+
+pub struct StateStore {
+    conn: Connection,
+}
+
+impl StateStore {
+    pub fn open(path: &Path) -> Result<Self> {
+        let conn = Connection::open(path)?;
+        let store = Self { conn };
+        store.init_schema()?;
+        Ok(store)
+    }
+
+    fn init_schema(&self) -> Result<()> {
+        self.conn.execute_batch(
+            "
+            CREATE TABLE IF NOT EXISTS sessions (
+                id TEXT PRIMARY KEY,
+                task TEXT NOT NULL,
+                agent_type TEXT NOT NULL,
+                state TEXT NOT NULL DEFAULT 'pending',
+                worktree_path TEXT,
+                worktree_branch TEXT,
+                worktree_base TEXT,
+                tokens_used INTEGER DEFAULT 0,
+                tool_calls INTEGER DEFAULT 0,
+                files_changed INTEGER DEFAULT 0,
+                duration_secs INTEGER DEFAULT 0,
+                cost_usd REAL DEFAULT 0.0,
+                created_at TEXT NOT NULL,
+                updated_at TEXT NOT NULL
+            );
+
+            CREATE TABLE IF NOT EXISTS tool_log (
+                id INTEGER PRIMARY KEY AUTOINCREMENT,
+                session_id TEXT NOT NULL REFERENCES sessions(id),
+                tool_name TEXT NOT NULL,
+                input_summary TEXT,
+                output_summary TEXT,
+                duration_ms INTEGER,
+                risk_score REAL DEFAULT 0.0,
+                timestamp TEXT NOT NULL
+            );
+
+            CREATE TABLE IF NOT EXISTS messages (
+                id INTEGER PRIMARY KEY AUTOINCREMENT,
+                from_session TEXT NOT NULL,
+                to_session TEXT NOT NULL,
+                content TEXT NOT NULL,
+                msg_type TEXT NOT NULL DEFAULT 'info',
+                read INTEGER DEFAULT 0,
+                timestamp TEXT NOT NULL
+            );
+
+            CREATE INDEX IF NOT EXISTS idx_sessions_state ON sessions(state);
+            CREATE INDEX IF NOT EXISTS idx_tool_log_session ON tool_log(session_id);
+            CREATE INDEX IF NOT EXISTS idx_messages_to ON messages(to_session, read);
+            ",
+        )?;
+        Ok(())
+    }
+
+    pub fn insert_session(&self, session: &Session) -> Result<()> {
+        self.conn.execute(
+            "INSERT INTO sessions (id, task, agent_type, state, worktree_path, worktree_branch, worktree_base, created_at, updated_at)
+             VALUES (?1, ?2, ?3, ?4, ?5, ?6, ?7, ?8, ?9)",
+            rusqlite::params![
+                session.id,
+                session.task,
+                session.agent_type,
+                session.state.to_string(),
+                session.worktree.as_ref().map(|w| w.path.to_string_lossy().to_string()),
+                session.worktree.as_ref().map(|w| w.branch.clone()),
+                session.worktree.as_ref().map(|w| w.base_branch.clone()),
+                session.created_at.to_rfc3339(),
+                session.updated_at.to_rfc3339(),
+            ],
+        )?;
+        Ok(())
+    }
+
+    pub fn update_state(&self, session_id: &str, state: &SessionState) -> Result<()> {
+        self.conn.execute(
+            "UPDATE sessions SET state = ?1, updated_at = ?2 WHERE id = ?3",
+            rusqlite::params![
+                state.to_string(),
+                chrono::Utc::now().to_rfc3339(),
+                session_id,
+            ],
+        )?;
+        Ok(())
+    }
+
+    pub fn update_metrics(&self, session_id: &str, metrics: &SessionMetrics) -> Result<()> {
+        self.conn.execute(
+            "UPDATE sessions SET tokens_used = ?1, tool_calls = ?2, files_changed = ?3, duration_secs = ?4, cost_usd = ?5, updated_at = ?6 WHERE id = ?7",
+            rusqlite::params![
+                metrics.tokens_used,
+                metrics.tool_calls,
+                metrics.files_changed,
+                metrics.duration_secs,
+                metrics.cost_usd,
+                chrono::Utc::now().to_rfc3339(),
+                session_id,
+            ],
+        )?;
+        Ok(())
+    }
+
+    pub fn list_sessions(&self) -> Result<Vec<Session>> {
+        let mut stmt = self.conn.prepare(
+            "SELECT id, task, agent_type, state, worktree_path, worktree_branch, worktree_base,
+                    tokens_used, tool_calls, files_changed, duration_secs, cost_usd,
+                    created_at, updated_at
+             FROM sessions ORDER BY updated_at DESC",
+        )?;
+
+        let sessions = stmt
+            .query_map([], |row| {
+                let state_str: String = row.get(3)?;
+                let state = match state_str.as_str() {
+                    "running" => SessionState::Running,
+                    "idle" => SessionState::Idle,
+                    "completed" => SessionState::Completed,
+                    "failed" => SessionState::Failed,
+                    "stopped" => SessionState::Stopped,
+                    _ => SessionState::Pending,
+                };
+
+                let worktree_path: Option<String> = row.get(4)?;
+                let worktree = worktree_path.map(|p| super::WorktreeInfo {
+                    path: std::path::PathBuf::from(p),
+                    branch: row.get::<_, String>(5).unwrap_or_default(),
+                    base_branch: row.get::<_, String>(6).unwrap_or_default(),
+                });
+
+                let created_str: String = row.get(12)?;
+                let updated_str: String = row.get(13)?;
+
+                Ok(Session {
+                    id: row.get(0)?,
+                    task: row.get(1)?,
+                    agent_type: row.get(2)?,
+                    state,
+                    worktree,
+                    created_at: chrono::DateTime::parse_from_rfc3339(&created_str)
+                        .unwrap_or_default()
+                        .with_timezone(&chrono::Utc),
+                    updated_at: chrono::DateTime::parse_from_rfc3339(&updated_str)
+                        .unwrap_or_default()
+                        .with_timezone(&chrono::Utc),
+                    metrics: SessionMetrics {
+                        tokens_used: row.get(7)?,
+                        tool_calls: row.get(8)?,
+                        files_changed: row.get(9)?,
+                        duration_secs: row.get(10)?,
+                        cost_usd: row.get(11)?,
+                    },
+                })
+            })?
+            .collect::<Result<Vec<_>, _>>()?;
+
+        Ok(sessions)
+    }
+
+    pub fn get_session(&self, id: &str) -> Result<Option<Session>> {
+        let sessions = self.list_sessions()?;
+        Ok(sessions
+            .into_iter()
+            .find(|s| s.id == id || s.id.starts_with(id)))
+    }
+
+    pub fn list_tool_logs(&self, session_id: &str, limit: usize) -> Result<Vec<ToolLogEntry>> {
+        let table_entries = self.list_tool_logs_from_table(session_id, limit)?;
+        if !table_entries.is_empty() {
+            return Ok(table_entries);
+        }
+
+        self.list_tool_logs_from_messages(session_id, limit)
+    }
+
+    pub fn send_message(&self, from: &str, to: &str, content: &str, msg_type: &str) -> Result<()> {
+        self.conn.execute(
+            "INSERT INTO messages (from_session, to_session, content, msg_type, timestamp)
+             VALUES (?1, ?2, ?3, ?4, ?5)",
+            rusqlite::params![from, to, content, msg_type, chrono::Utc::now().to_rfc3339()],
+        )?;
+        Ok(())
+    }
+
+    fn list_tool_logs_from_table(
+        &self,
+        session_id: &str,
+        limit: usize,
+    ) -> Result<Vec<ToolLogEntry>> {
+        let mut stmt = self.conn.prepare(
+            "SELECT tool_name,
+                    COALESCE(input_summary, ''),
+                    COALESCE(output_summary, ''),
+                    COALESCE(duration_ms, 0),
+                    risk_score,
+                    timestamp
+             FROM tool_log
+             WHERE session_id = ?1
+             ORDER BY timestamp DESC
+             LIMIT ?2",
+        )?;
+
+        let entries = stmt
+            .query_map(rusqlite::params![session_id, limit as i64], |row| {
+                Ok(ToolLogEntry {
+                    tool_name: row.get(0)?,
+                    input_summary: row.get(1)?,
+                    output_summary: row.get(2)?,
+                    duration_ms: row.get(3)?,
+                    risk_score: row.get(4)?,
+                    timestamp: row.get(5)?,
+                })
+            })?
+            .collect::<Result<Vec<_>, _>>()?;
+
+        Ok(entries)
+    }
+
+    fn list_tool_logs_from_messages(
+        &self,
+        session_id: &str,
+        limit: usize,
+    ) -> Result<Vec<ToolLogEntry>> {
+        let mut stmt = self.conn.prepare(
+            "SELECT content, timestamp
+             FROM messages
+             WHERE from_session = ?1 AND msg_type = 'tool_call'
+             ORDER BY timestamp DESC
+             LIMIT ?2",
+        )?;
+
+        let rows = stmt
+            .query_map(rusqlite::params![session_id, limit as i64], |row| {
+                Ok((row.get::<_, String>(0)?, row.get::<_, String>(1)?))
+            })?
+            .collect::<Result<Vec<_>, _>>()?;
+
+        let entries = rows
+            .into_iter()
+            .filter_map(|(content, timestamp)| {
+                serde_json::from_str::<ToolCallEvent>(&content)
+                    .ok()
+                    .map(|event| ToolLogEntry {
+                        tool_name: event.tool_name,
+                        input_summary: event.input_summary,
+                        output_summary: event.output_summary,
+                        duration_ms: event.duration_ms,
+                        risk_score: event.risk_score,
+                        timestamp,
+                    })
+            })
+            .collect();
+
+        Ok(entries)
+    }
+}
--- a/ecc2/src/tui/app.rs
+++ b/ecc2/src/tui/app.rs
@@ -0,0 +1,56 @@
+use anyhow::Result;
+use crossterm::{
+    event::{self, Event, KeyCode, KeyModifiers},
+    execute,
+    terminal::{disable_raw_mode, enable_raw_mode, EnterAlternateScreen, LeaveAlternateScreen},
+};
+use ratatui::prelude::*;
+use std::io;
+use std::time::Duration;
+
+use super::dashboard::Dashboard;
+use crate::config::Config;
+use crate::session::store::StateStore;
+
+pub async fn run(db: StateStore, cfg: Config) -> Result<()> {
+    enable_raw_mode()?;
+    let mut stdout = io::stdout();
+    execute!(stdout, EnterAlternateScreen)?;
+
+    let backend = CrosstermBackend::new(stdout);
+    let mut terminal = Terminal::new(backend)?;
+
+    let mut dashboard = Dashboard::new(db, cfg);
+
+    loop {
+        terminal.draw(|frame| dashboard.render(frame))?;
+
+        if event::poll(Duration::from_millis(250))? {
+            if let Event::Key(key) = event::read()? {
+                match (key.modifiers, key.code) {
+                    (KeyModifiers::CONTROL, KeyCode::Char('c')) => break,
+                    (_, KeyCode::Char('q')) => break,
+                    (_, KeyCode::Tab) => dashboard.next_pane(),
+                    (KeyModifiers::SHIFT, KeyCode::BackTab) => dashboard.prev_pane(),
+                    (_, KeyCode::Char('+')) | (_, KeyCode::Char('=')) => {
+                        dashboard.increase_pane_size()
+                    }
+                    (_, KeyCode::Char('-')) => dashboard.decrease_pane_size(),
+                    (_, KeyCode::Char('j')) | (_, KeyCode::Down) => dashboard.scroll_down(),
+                    (_, KeyCode::Char('k')) | (_, KeyCode::Up) => dashboard.scroll_up(),
+                    (_, KeyCode::Char('n')) => dashboard.new_session(),
+                    (_, KeyCode::Char('s')) => dashboard.stop_selected(),
+                    (_, KeyCode::Char('r')) => dashboard.refresh(),
+                    (_, KeyCode::Char('?')) => dashboard.toggle_help(),
+                    _ => {}
+                }
+            }
+        }
+
+        dashboard.tick().await;
+    }
+
+    disable_raw_mode()?;
+    execute!(terminal.backend_mut(), LeaveAlternateScreen)?;
+    Ok(())
+}
--- a/ecc2/src/tui/dashboard.rs
+++ b/ecc2/src/tui/dashboard.rs
@@ -0,0 +1,644 @@
+use ratatui::{
+    prelude::*,
+    widgets::{Block, Borders, List, ListItem, Paragraph, Tabs, Wrap},
+};
+
+use crate::config::{Config, PaneLayout};
+use crate::session::store::{StateStore, ToolLogEntry};
+use crate::session::{Session, SessionState};
+
+const DEFAULT_PANE_SIZE_PERCENT: u16 = 35;
+const DEFAULT_GRID_SIZE_PERCENT: u16 = 50;
+const OUTPUT_PANE_PERCENT: u16 = 70;
+const MIN_PANE_SIZE_PERCENT: u16 = 20;
+const MAX_PANE_SIZE_PERCENT: u16 = 80;
+const PANE_RESIZE_STEP_PERCENT: u16 = 5;
+const MAX_LOG_ENTRIES: usize = 12;
+
+pub struct Dashboard {
+    db: StateStore,
+    cfg: Config,
+    sessions: Vec<Session>,
+    logs: Vec<ToolLogEntry>,
+    selected_pane: Pane,
+    selected_session: usize,
+    show_help: bool,
+    scroll_offset: usize,
+    pane_size_percent: u16,
+}
+
+#[derive(Debug, Clone, Copy, PartialEq, Eq)]
+enum Pane {
+    Sessions,
+    Output,
+    Metrics,
+    Log,
+}
+
+#[derive(Debug, Clone, Copy)]
+struct PaneAreas {
+    sessions: Rect,
+    output: Rect,
+    metrics: Rect,
+    log: Option<Rect>,
+}
+
+impl Dashboard {
+    pub fn new(db: StateStore, cfg: Config) -> Self {
+        let pane_size_percent = match cfg.pane_layout {
+            PaneLayout::Grid => DEFAULT_GRID_SIZE_PERCENT,
+            PaneLayout::Horizontal | PaneLayout::Vertical => DEFAULT_PANE_SIZE_PERCENT,
+        };
+
+        let sessions = db.list_sessions().unwrap_or_default();
+        let mut dashboard = Self {
+            db,
+            cfg,
+            sessions,
+            logs: Vec::new(),
+            selected_pane: Pane::Sessions,
+            selected_session: 0,
+            show_help: false,
+            scroll_offset: 0,
+            pane_size_percent,
+        };
+        dashboard.refresh_logs();
+        dashboard
+    }
+
+    pub fn render(&self, frame: &mut Frame) {
+        let chunks = Layout::default()
+            .direction(Direction::Vertical)
+            .constraints([
+                Constraint::Length(3),
+                Constraint::Min(10),
+                Constraint::Length(3),
+            ])
+            .split(frame.area());
+
+        self.render_header(frame, chunks[0]);
+
+        if self.show_help {
+            self.render_help(frame, chunks[1]);
+        } else {
+            let pane_areas = self.pane_areas(chunks[1]);
+            self.render_sessions(frame, pane_areas.sessions);
+            self.render_output(frame, pane_areas.output);
+            self.render_metrics(frame, pane_areas.metrics);
+
+            if let Some(log_area) = pane_areas.log {
+                self.render_log(frame, log_area);
+            }
+        }
+
+        self.render_status_bar(frame, chunks[2]);
+    }
+
+    fn render_header(&self, frame: &mut Frame, area: Rect) {
+        let running = self
+            .sessions
+            .iter()
+            .filter(|session| session.state == SessionState::Running)
+            .count();
+        let total = self.sessions.len();
+        let title = format!(
+            " ECC 2.0 | {running} running / {total} total | {} {}% ",
+            self.layout_label(),
+            self.pane_size_percent
+        );
+
+        let tabs = Tabs::new(
+            self.visible_panes()
+                .iter()
+                .map(|pane| pane.title())
+                .collect::<Vec<_>>(),
+        )
+        .block(Block::default().borders(Borders::ALL).title(title))
+        .select(self.selected_pane_index())
+        .highlight_style(
+            Style::default()
+                .fg(Color::Cyan)
+                .add_modifier(Modifier::BOLD),
+        );
+
+        frame.render_widget(tabs, area);
+    }
+
+    fn render_sessions(&self, frame: &mut Frame, area: Rect) {
+        let items: Vec<ListItem> = if self.sessions.is_empty() {
+            vec![ListItem::new("No sessions. Press 'n' to start one.")]
+        } else {
+            self.sessions
+                .iter()
+                .enumerate()
+                .map(|(index, session)| {
+                    let state_icon = match session.state {
+                        SessionState::Running => "●",
+                        SessionState::Idle => "○",
+                        SessionState::Completed => "✓",
+                        SessionState::Failed => "✗",
+                        SessionState::Stopped => "■",
+                        SessionState::Pending => "◌",
+                    };
+
+                    let style = if index == self.selected_session {
+                        Style::default()
+                            .fg(Color::Cyan)
+                            .add_modifier(Modifier::BOLD)
+                    } else {
+                        Style::default()
+                    };
+
+                    let text = format!(
+                        "{state_icon} {} [{}] {}",
+                        &session.id[..8.min(session.id.len())],
+                        session.agent_type,
+                        session.task
+                    );
+
+                    ListItem::new(text).style(style)
+                })
+                .collect()
+        };
+
+        let list = List::new(items).block(
+            Block::default()
+                .borders(Borders::ALL)
+                .title(" Sessions ")
+                .border_style(self.pane_border_style(Pane::Sessions)),
+        );
+        frame.render_widget(list, area);
+    }
+
+    fn render_output(&self, frame: &mut Frame, area: Rect) {
+        let content = if let Some(session) = self.current_session() {
+            let worktree = session
+                .worktree
+                .as_ref()
+                .map(|worktree| {
+                    format!(
+                        "Worktree: {}\nBranch: {}\n",
+                        worktree.path.display(),
+                        worktree.branch
+                    )
+                })
+                .unwrap_or_default();
+
+            format!(
+                "Session: {}\nAgent: {}\nState: {}\nTask: {}\nUpdated: {}\n{}\
+                 \nLive streaming output is not wired yet. Session context is shown here until the stream viewer lands.",
+                session.id,
+                session.agent_type,
+                session.state,
+                session.task,
+                session.updated_at.format("%Y-%m-%d %H:%M:%S UTC"),
+                worktree
+            )
+        } else {
+            "No sessions. Press 'n' to start one.".to_string()
+        };
+
+        let paragraph = Paragraph::new(content)
+            .block(
+                Block::default()
+                    .borders(Borders::ALL)
+                    .title(" Output ")
+                    .border_style(self.pane_border_style(Pane::Output)),
+            )
+            .scroll((self.scroll_offset_u16(), 0))
+            .wrap(Wrap { trim: false });
+        frame.render_widget(paragraph, area);
+    }
+
+    fn render_metrics(&self, frame: &mut Frame, area: Rect) {
+        let content = if let Some(session) = self.current_session() {
+            let metrics = &session.metrics;
+            format!(
+                "Tokens: {}\nTools: {}\nFiles: {}\nCost: ${:.4}\nDuration: {}s",
+                metrics.tokens_used,
+                metrics.tool_calls,
+                metrics.files_changed,
+                metrics.cost_usd,
+                metrics.duration_secs
+            )
+        } else {
+            "No metrics available".to_string()
+        };
+
+        let paragraph = Paragraph::new(content)
+            .block(
+                Block::default()
+                    .borders(Borders::ALL)
+                    .title(" Metrics ")
+                    .border_style(self.pane_border_style(Pane::Metrics)),
+            )
+            .scroll((self.scroll_offset_u16(), 0))
+            .wrap(Wrap { trim: false });
+        frame.render_widget(paragraph, area);
+    }
+
+    fn render_log(&self, frame: &mut Frame, area: Rect) {
+        let content = if self.current_session().is_none() {
+            "No session selected".to_string()
+        } else if self.logs.is_empty() {
+            "No tool logs available for this session.\n\nTool call observability events will appear here when they are recorded."
+                .to_string()
+        } else {
+            self.logs
+                .iter()
+                .map(|entry| {
+                    format!(
+                        "[{}] {} | {}ms | risk {:.0}%\ninput: {}\noutput: {}",
+                        self.short_timestamp(&entry.timestamp),
+                        entry.tool_name,
+                        entry.duration_ms,
+                        entry.risk_score * 100.0,
+                        self.log_field(&entry.input_summary),
+                        self.log_field(&entry.output_summary)
+                    )
+                })
+                .collect::<Vec<_>>()
+                .join("\n\n")
+        };
+
+        let paragraph = Paragraph::new(content)
+            .block(
+                Block::default()
+                    .borders(Borders::ALL)
+                    .title(" Log ")
+                    .border_style(self.pane_border_style(Pane::Log)),
+            )
+            .scroll((self.scroll_offset_u16(), 0))
+            .wrap(Wrap { trim: false });
+        frame.render_widget(paragraph, area);
+    }
+
+    fn render_status_bar(&self, frame: &mut Frame, area: Rect) {
+        let text = format!(
+            " [n]ew session  [s]top  [Tab] switch pane  [j/k] scroll  [+/-] resize  [{}] layout  [?] help  [q]uit ",
+            self.layout_label()
+        );
+
+        let paragraph = Paragraph::new(text)
+            .style(Style::default().fg(Color::DarkGray))
+            .block(Block::default().borders(Borders::ALL));
+        frame.render_widget(paragraph, area);
+    }
+
+    fn render_help(&self, frame: &mut Frame, area: Rect) {
+        let help = vec![
+            "Keyboard Shortcuts:",
+            "",
+            "  n       New session",
+            "  s       Stop selected session",
+            "  Tab     Next pane",
+            "  S-Tab   Previous pane",
+            "  j/↓     Scroll down",
+            "  k/↑     Scroll up",
+            "  +/=     Increase pane size",
+            "  -       Decrease pane size",
+            "  r       Refresh",
+            "  ?       Toggle help",
+            "  q/C-c   Quit",
+        ];
+
+        let paragraph = Paragraph::new(help.join("\n")).block(
+            Block::default()
+                .borders(Borders::ALL)
+                .title(" Help ")
+                .border_style(Style::default().fg(Color::Yellow)),
+        );
+        frame.render_widget(paragraph, area);
+    }
+
+    pub fn next_pane(&mut self) {
+        let visible_panes = self.visible_panes();
+        let next_index = self
+            .selected_pane_index()
+            .checked_add(1)
+            .map(|index| index % visible_panes.len())
+            .unwrap_or(0);
+
+        self.selected_pane = visible_panes[next_index];
+        self.scroll_offset = 0;
+    }
+
+    pub fn prev_pane(&mut self) {
+        let visible_panes = self.visible_panes();
+        let previous_index = if self.selected_pane_index() == 0 {
+            visible_panes.len() - 1
+        } else {
+            self.selected_pane_index() - 1
+        };
+
+        self.selected_pane = visible_panes[previous_index];
+        self.scroll_offset = 0;
+    }
+
+    pub fn increase_pane_size(&mut self) {
+        self.pane_size_percent =
+            (self.pane_size_percent + PANE_RESIZE_STEP_PERCENT).min(MAX_PANE_SIZE_PERCENT);
+    }
+
+    pub fn decrease_pane_size(&mut self) {
+        self.pane_size_percent = self
+            .pane_size_percent
+            .saturating_sub(PANE_RESIZE_STEP_PERCENT)
+            .max(MIN_PANE_SIZE_PERCENT);
+    }
+
+    pub fn scroll_down(&mut self) {
+        if self.selected_pane == Pane::Sessions && !self.sessions.is_empty() {
+            self.selected_session = (self.selected_session + 1).min(self.sessions.len() - 1);
+            self.scroll_offset = 0;
+            self.refresh_logs();
+        } else {
+            self.scroll_offset = self.scroll_offset.saturating_add(1);
+        }
+    }
+
+    pub fn scroll_up(&mut self) {
+        if self.selected_pane == Pane::Sessions {
+            let previous_index = self.selected_session;
+            self.selected_session = self.selected_session.saturating_sub(1);
+
+            if self.selected_session != previous_index {
+                self.scroll_offset = 0;
+                self.refresh_logs();
+            }
+        } else {
+            self.scroll_offset = self.scroll_offset.saturating_sub(1);
+        }
+    }
+
+    pub fn new_session(&mut self) {
+        tracing::info!("New session dialog requested");
+    }
+
+    pub fn stop_selected(&mut self) {
+        if let Some(session) = self.sessions.get(self.selected_session) {
+            let _ = self.db.update_state(&session.id, &SessionState::Stopped);
+            self.refresh();
+        }
+    }
+
+    pub fn refresh(&mut self) {
+        self.sync_from_store();
+    }
+
+    pub fn toggle_help(&mut self) {
+        self.show_help = !self.show_help;
+    }
+
+    pub async fn tick(&mut self) {
+        self.sync_from_store();
+    }
+
+    fn sync_from_store(&mut self) {
+        self.sessions = self.db.list_sessions().unwrap_or_default();
+        self.clamp_selected_session();
+        self.ensure_selected_pane_visible();
+        self.refresh_logs();
+    }
+
+    fn current_session(&self) -> Option<&Session> {
+        self.sessions.get(self.selected_session)
+    }
+
+    fn refresh_logs(&mut self) {
+        let session_id = self.current_session().map(|session| session.id.clone());
+
+        self.logs = session_id
+            .and_then(|id| self.db.list_tool_logs(&id, MAX_LOG_ENTRIES).ok())
+            .unwrap_or_default();
+    }
+
+    fn clamp_selected_session(&mut self) {
+        if self.sessions.is_empty() {
+            self.selected_session = 0;
+            return;
+        }
+
+        self.selected_session = self.selected_session.min(self.sessions.len() - 1);
+    }
+
+    fn ensure_selected_pane_visible(&mut self) {
+        if !self.visible_panes().contains(&self.selected_pane) {
+            self.selected_pane = Pane::Sessions;
+        }
+    }
+
+    fn pane_areas(&self, area: Rect) -> PaneAreas {
+        match self.cfg.pane_layout {
+            PaneLayout::Horizontal => {
+                let columns = Layout::default()
+                    .direction(Direction::Horizontal)
+                    .constraints(self.primary_constraints())
+                    .split(area);
+                let right_rows = Layout::default()
+                    .direction(Direction::Vertical)
+                    .constraints([
+                        Constraint::Percentage(OUTPUT_PANE_PERCENT),
+                        Constraint::Percentage(100 - OUTPUT_PANE_PERCENT),
+                    ])
+                    .split(columns[1]);
+
+                PaneAreas {
+                    sessions: columns[0],
+                    output: right_rows[0],
+                    metrics: right_rows[1],
+                    log: None,
+                }
+            }
+            PaneLayout::Vertical => {
+                let rows = Layout::default()
+                    .direction(Direction::Vertical)
+                    .constraints(self.primary_constraints())
+                    .split(area);
+                let bottom_columns = Layout::default()
+                    .direction(Direction::Horizontal)
+                    .constraints([
+                        Constraint::Percentage(OUTPUT_PANE_PERCENT),
+                        Constraint::Percentage(100 - OUTPUT_PANE_PERCENT),
+                    ])
+                    .split(rows[1]);
+
+                PaneAreas {
+                    sessions: rows[0],
+                    output: bottom_columns[0],
+                    metrics: bottom_columns[1],
+                    log: None,
+                }
+            }
+            PaneLayout::Grid => {
+                let rows = Layout::default()
+                    .direction(Direction::Vertical)
+                    .constraints(self.primary_constraints())
+                    .split(area);
+                let top_columns = Layout::default()
+                    .direction(Direction::Horizontal)
+                    .constraints(self.primary_constraints())
+                    .split(rows[0]);
+                let bottom_columns = Layout::default()
+                    .direction(Direction::Horizontal)
+                    .constraints(self.primary_constraints())
+                    .split(rows[1]);
+
+                PaneAreas {
+                    sessions: top_columns[0],
+                    output: top_columns[1],
+                    metrics: bottom_columns[0],
+                    log: Some(bottom_columns[1]),
+                }
+            }
+        }
+    }
+
+    fn primary_constraints(&self) -> [Constraint; 2] {
+        [
+            Constraint::Percentage(self.pane_size_percent),
+            Constraint::Percentage(100 - self.pane_size_percent),
+        ]
+    }
+
+    fn visible_panes(&self) -> &'static [Pane] {
+        match self.cfg.pane_layout {
+            PaneLayout::Grid => &[Pane::Sessions, Pane::Output, Pane::Metrics, Pane::Log],
+            PaneLayout::Horizontal | PaneLayout::Vertical => {
+                &[Pane::Sessions, Pane::Output, Pane::Metrics]
+            }
+        }
+    }
+
+    fn selected_pane_index(&self) -> usize {
+        self.visible_panes()
+            .iter()
+            .position(|pane| *pane == self.selected_pane)
+            .unwrap_or(0)
+    }
+
+    fn pane_border_style(&self, pane: Pane) -> Style {
+        if self.selected_pane == pane {
+            Style::default().fg(Color::Cyan)
+        } else {
+            Style::default()
+        }
+    }
+
+    fn layout_label(&self) -> &'static str {
+        match self.cfg.pane_layout {
+            PaneLayout::Horizontal => "horizontal",
+            PaneLayout::Vertical => "vertical",
+            PaneLayout::Grid => "grid",
+        }
+    }
+
+    fn scroll_offset_u16(&self) -> u16 {
+        self.scroll_offset.min(u16::MAX as usize) as u16
+    }
+
+    fn log_field<'a>(&self, value: &'a str) -> &'a str {
+        let trimmed = value.trim();
+        if trimmed.is_empty() {
+            "n/a"
+        } else {
+            trimmed
+        }
+    }
+
+    fn short_timestamp(&self, timestamp: &str) -> String {
+        chrono::DateTime::parse_from_rfc3339(timestamp)
+            .map(|value| value.format("%H:%M:%S").to_string())
+            .unwrap_or_else(|_| timestamp.to_string())
+    }
+}
+
+impl Pane {
+    fn title(self) -> &'static str {
+        match self {
+            Pane::Sessions => "Sessions",
+            Pane::Output => "Output",
+            Pane::Metrics => "Metrics",
+            Pane::Log => "Log",
+        }
+    }
+}
+
+#[cfg(test)]
+mod tests {
+    use super::{
+        Dashboard, Pane, DEFAULT_GRID_SIZE_PERCENT, MAX_PANE_SIZE_PERCENT, MIN_PANE_SIZE_PERCENT,
+    };
+    use crate::config::{Config, PaneLayout};
+    use crate::session::store::StateStore;
+    use ratatui::layout::Rect;
+
+    fn dashboard_for(layout: PaneLayout) -> Dashboard {
+        let mut cfg = Config::default();
+        cfg.pane_layout = layout;
+
+        let db_path =
+            std::env::temp_dir().join(format!("ecc-dashboard-test-{}.db", uuid::Uuid::new_v4()));
+        let db = StateStore::open(&db_path).unwrap();
+
+        Dashboard::new(db, cfg)
+    }
+
+    #[test]
+    fn grid_layout_uses_four_panes_in_two_rows() {
+        let dashboard = dashboard_for(PaneLayout::Grid);
+        let areas = dashboard.pane_areas(Rect::new(0, 0, 100, 40));
+        let log_area = areas.log.expect("grid layout should render a log pane");
+
+        assert_eq!(areas.sessions.y, areas.output.y);
+        assert_eq!(areas.metrics.y, log_area.y);
+        assert!(areas.metrics.y > areas.sessions.y);
+        assert_eq!(areas.sessions.x, 0);
+        assert_eq!(areas.metrics.x, 0);
+        assert!(areas.output.x > areas.sessions.x);
+        assert!(log_area.x > areas.metrics.x);
+    }
+
+    #[test]
+    fn non_grid_layouts_hide_the_log_pane() {
+        let horizontal = dashboard_for(PaneLayout::Horizontal);
+        let vertical = dashboard_for(PaneLayout::Vertical);
+
+        assert!(horizontal
+            .pane_areas(Rect::new(0, 0, 100, 40))
+            .log
+            .is_none());
+        assert!(vertical.pane_areas(Rect::new(0, 0, 100, 40)).log.is_none());
+    }
+
+    #[test]
+    fn pane_navigation_includes_log_only_for_grid_layouts() {
+        let mut horizontal = dashboard_for(PaneLayout::Horizontal);
+        horizontal.next_pane();
+        horizontal.next_pane();
+        horizontal.next_pane();
+        assert_eq!(horizontal.selected_pane, Pane::Sessions);
+
+        let mut grid = dashboard_for(PaneLayout::Grid);
+        grid.next_pane();
+        grid.next_pane();
+        grid.next_pane();
+        assert_eq!(grid.selected_pane, Pane::Log);
+    }
+
+    #[test]
+    fn pane_resize_clamps_to_supported_bounds() {
+        let mut dashboard = dashboard_for(PaneLayout::Grid);
+        assert_eq!(dashboard.pane_size_percent, DEFAULT_GRID_SIZE_PERCENT);
+
+        for _ in 0..20 {
+            dashboard.increase_pane_size();
+        }
+        assert_eq!(dashboard.pane_size_percent, MAX_PANE_SIZE_PERCENT);
+
+        for _ in 0..40 {
+            dashboard.decrease_pane_size();
+        }
+        assert_eq!(dashboard.pane_size_percent, MIN_PANE_SIZE_PERCENT);
+    }
+}
--- a/ecc2/src/tui/mod.rs
+++ b/ecc2/src/tui/mod.rs
@@ -0,0 +1,3 @@
+pub mod app;
+mod dashboard;
+mod widgets;
--- a/ecc2/src/tui/widgets.rs
+++ b/ecc2/src/tui/widgets.rs
@@ -0,0 +1,6 @@
+// Custom TUI widgets for ECC 2.0
+// TODO: Implement custom widgets:
+// - TokenMeter: visual token usage bar with budget threshold
+// - DiffViewer: side-by-side syntax-highlighted diff display
+// - ProgressTimeline: session timeline with tool call markers
+// - AgentTree: hierarchical view of parent/child agent sessions
--- a/ecc2/src/worktree/mod.rs
+++ b/ecc2/src/worktree/mod.rs
@@ -0,0 +1,80 @@
+use anyhow::{Context, Result};
+use std::path::PathBuf;
+use std::process::Command;
+
+use crate::config::Config;
+use crate::session::WorktreeInfo;
+
+/// Create a new git worktree for an agent session.
+pub fn create_for_session(session_id: &str, cfg: &Config) -> Result<WorktreeInfo> {
+    let branch = format!("ecc/{session_id}");
+    let path = cfg.worktree_root.join(session_id);
+
+    // Get current branch as base
+    let base = get_current_branch()?;
+
+    std::fs::create_dir_all(&cfg.worktree_root)
+        .context("Failed to create worktree root directory")?;
+
+    let output = Command::new("git")
+        .args(["worktree", "add", "-b", &branch])
+        .arg(&path)
+        .arg("HEAD")
+        .output()
+        .context("Failed to run git worktree add")?;
+
+    if !output.status.success() {
+        let stderr = String::from_utf8_lossy(&output.stderr);
+        anyhow::bail!("git worktree add failed: {stderr}");
+    }
+
+    tracing::info!("Created worktree at {} on branch {}", path.display(), branch);
+
+    Ok(WorktreeInfo {
+        path,
+        branch,
+        base_branch: base,
+    })
+}
+
+/// Remove a worktree and its branch.
+pub fn remove(path: &PathBuf) -> Result<()> {
+    let output = Command::new("git")
+        .args(["worktree", "remove", "--force"])
+        .arg(path)
+        .output()
+        .context("Failed to remove worktree")?;
+
+    if !output.status.success() {
+        let stderr = String::from_utf8_lossy(&output.stderr);
+        tracing::warn!("Worktree removal warning: {stderr}");
+    }
+
+    Ok(())
+}
+
+/// List all active worktrees.
+pub fn list() -> Result<Vec<String>> {
+    let output = Command::new("git")
+        .args(["worktree", "list", "--porcelain"])
+        .output()
+        .context("Failed to list worktrees")?;
+
+    let stdout = String::from_utf8_lossy(&output.stdout);
+    let worktrees: Vec<String> = stdout
+        .lines()
+        .filter(|l| l.starts_with("worktree "))
+        .map(|l| l.trim_start_matches("worktree ").to_string())
+        .collect();
+
+    Ok(worktrees)
+}
+
+fn get_current_branch() -> Result<String> {
+    let output = Command::new("git")
+        .args(["rev-parse", "--abbrev-ref", "HEAD"])
+        .output()
+        .context("Failed to get current branch")?;
+
+    Ok(String::from_utf8_lossy(&output.stdout).trim().to_string())
+}
Author	SHA1	Message	Date
ecc-tools[bot]	ba43de5dd0	feat: add everything-claude-code ECC bundle (.claude/commands/add-or-update-ecc-command-doc.md)	2026-03-24 10:44:29 +00:00
ecc-tools[bot]	288ffa4c1e	feat: add everything-claude-code ECC bundle (.claude/commands/feature-development.md)	2026-03-24 10:44:28 +00:00
ecc-tools[bot]	9f33a2b556	feat: add everything-claude-code ECC bundle (.claude/commands/database-migration.md)	2026-03-24 10:44:27 +00:00
ecc-tools[bot]	707b360fe5	feat: add everything-claude-code ECC bundle (.claude/enterprise/controls.md)	2026-03-24 10:44:26 +00:00
ecc-tools[bot]	1f64ee1cde	feat: add everything-claude-code ECC bundle (.claude/team/everything-claude-code-team-config.json)	2026-03-24 10:44:25 +00:00
ecc-tools[bot]	471554e2fd	feat: add everything-claude-code ECC bundle (.claude/research/everything-claude-code-research-playbook.md)	2026-03-24 10:44:24 +00:00
ecc-tools[bot]	06ca450291	feat: add everything-claude-code ECC bundle (.claude/rules/everything-claude-code-guardrails.md)	2026-03-24 10:44:24 +00:00
ecc-tools[bot]	6dc955fab5	feat: add everything-claude-code ECC bundle (.codex/agents/docs-researcher.toml)	2026-03-24 10:44:22 +00:00
ecc-tools[bot]	e373b4d27e	feat: add everything-claude-code ECC bundle (.codex/agents/reviewer.toml)	2026-03-24 10:44:21 +00:00
ecc-tools[bot]	c77a5b825b	feat: add everything-claude-code ECC bundle (.codex/agents/explorer.toml)	2026-03-24 10:44:21 +00:00
ecc-tools[bot]	2a2ac42ad9	feat: add everything-claude-code ECC bundle (.claude/identity.json)	2026-03-24 10:44:19 +00:00
ecc-tools[bot]	fe0546d134	feat: add everything-claude-code ECC bundle (.agents/skills/everything-claude-code/agents/openai.yaml)	2026-03-24 10:44:19 +00:00
ecc-tools[bot]	7adef06fd1	feat: add everything-claude-code ECC bundle (.agents/skills/everything-claude-code/SKILL.md)	2026-03-24 10:44:18 +00:00
ecc-tools[bot]	bb87544ce9	feat: add everything-claude-code ECC bundle (.claude/skills/everything-claude-code/SKILL.md)	2026-03-24 10:44:17 +00:00
ecc-tools[bot]	240eb0a356	feat: add everything-claude-code ECC bundle (.claude/ecc-tools.json)	2026-03-24 10:44:16 +00:00
ecc-tools[bot]	bb06e9f557	feat: add everything-claude-code ECC bundle (.claude/commands/add-or-update-skill.md)	2026-03-24 10:43:40 +00:00
ecc-tools[bot]	fb17de2425	feat: add everything-claude-code ECC bundle (.claude/commands/feature-development.md)	2026-03-24 10:43:39 +00:00
ecc-tools[bot]	7762026d9e	feat: add everything-claude-code ECC bundle (.claude/commands/database-migration.md)	2026-03-24 10:43:38 +00:00
ecc-tools[bot]	49df1d3007	feat: add everything-claude-code ECC bundle (.claude/enterprise/controls.md)	2026-03-24 10:43:37 +00:00
ecc-tools[bot]	5a5e09a7fc	feat: add everything-claude-code ECC bundle (.claude/team/everything-claude-code-team-config.json)	2026-03-24 10:43:37 +00:00
ecc-tools[bot]	2e897de270	feat: add everything-claude-code ECC bundle (.claude/research/everything-claude-code-research-playbook.md)	2026-03-24 10:43:36 +00:00
ecc-tools[bot]	256dd55cfd	feat: add everything-claude-code ECC bundle (.claude/rules/everything-claude-code-guardrails.md)	2026-03-24 10:43:35 +00:00
ecc-tools[bot]	3ad2db4f19	feat: add everything-claude-code ECC bundle (.codex/agents/docs-researcher.toml)	2026-03-24 10:43:34 +00:00
ecc-tools[bot]	e1ec37f40a	feat: add everything-claude-code ECC bundle (.codex/agents/reviewer.toml)	2026-03-24 10:43:33 +00:00
ecc-tools[bot]	f685e0eab5	feat: add everything-claude-code ECC bundle (.codex/agents/explorer.toml)	2026-03-24 10:43:32 +00:00
ecc-tools[bot]	e4883ef634	feat: add everything-claude-code ECC bundle (.claude/identity.json)	2026-03-24 10:43:31 +00:00
ecc-tools[bot]	fe0dfc108a	feat: add everything-claude-code ECC bundle (.agents/skills/everything-claude-code/agents/openai.yaml)	2026-03-24 10:43:30 +00:00
ecc-tools[bot]	78a6a91839	feat: add everything-claude-code ECC bundle (.agents/skills/everything-claude-code/SKILL.md)	2026-03-24 10:43:29 +00:00
ecc-tools[bot]	0ce8b82fbb	feat: add everything-claude-code ECC bundle (.claude/skills/everything-claude-code/SKILL.md)	2026-03-24 10:43:29 +00:00
ecc-tools[bot]	2f8abe36c1	feat: add everything-claude-code ECC bundle (.claude/ecc-tools.json)	2026-03-24 10:43:28 +00:00
ecc-tools[bot]	0d72a80099	feat: add everything-claude-code ECC bundle (.claude/commands/add-or-update-skill-documentation.md)	2026-03-24 10:42:48 +00:00
ecc-tools[bot]	a13930a1b4	feat: add everything-claude-code ECC bundle (.claude/commands/feature-development.md)	2026-03-24 10:42:47 +00:00
ecc-tools[bot]	cf95bb9870	feat: add everything-claude-code ECC bundle (.claude/commands/database-migration.md)	2026-03-24 10:42:46 +00:00
ecc-tools[bot]	57a55733ba	feat: add everything-claude-code ECC bundle (.claude/enterprise/controls.md)	2026-03-24 10:42:45 +00:00
ecc-tools[bot]	3999f99ea3	feat: add everything-claude-code ECC bundle (.claude/team/everything-claude-code-team-config.json)	2026-03-24 10:42:44 +00:00
ecc-tools[bot]	b7e295a3bd	feat: add everything-claude-code ECC bundle (.claude/research/everything-claude-code-research-playbook.md)	2026-03-24 10:42:43 +00:00
ecc-tools[bot]	93dc7e8fd0	feat: add everything-claude-code ECC bundle (.claude/rules/everything-claude-code-guardrails.md)	2026-03-24 10:42:42 +00:00
ecc-tools[bot]	cd50de7423	feat: add everything-claude-code ECC bundle (.codex/agents/docs-researcher.toml)	2026-03-24 10:42:42 +00:00
ecc-tools[bot]	0366bdfdeb	feat: add everything-claude-code ECC bundle (.codex/agents/reviewer.toml)	2026-03-24 10:42:41 +00:00
ecc-tools[bot]	99db2f4928	feat: add everything-claude-code ECC bundle (.codex/agents/explorer.toml)	2026-03-24 10:42:40 +00:00
ecc-tools[bot]	38fbff0d83	feat: add everything-claude-code ECC bundle (.claude/identity.json)	2026-03-24 10:42:39 +00:00
ecc-tools[bot]	b6f633b810	feat: add everything-claude-code ECC bundle (.agents/skills/everything-claude-code/agents/openai.yaml)	2026-03-24 10:42:38 +00:00
ecc-tools[bot]	34149411fa	feat: add everything-claude-code ECC bundle (.agents/skills/everything-claude-code/SKILL.md)	2026-03-24 10:42:37 +00:00
ecc-tools[bot]	24c0aac4df	feat: add everything-claude-code ECC bundle (.claude/skills/everything-claude-code/SKILL.md)	2026-03-24 10:42:36 +00:00
ecc-tools[bot]	f59a9ebcea	feat: add everything-claude-code ECC bundle (.claude/ecc-tools.json)	2026-03-24 10:42:35 +00:00
Affaan Mustafa	ffc2c662a7	feat(ecc2): add split-pane dashboard resizing	2026-03-24 03:39:53 -07:00
Affaan Mustafa	b032846806	feat: scaffold ECC 2.0 Rust TUI — agentic IDE control plane Initial scaffold for ECC 2.0, a terminal-native agentic IDE built with Ratatui. Compiles to a 3.4MB single binary. Core modules: - Session manager with SQLite-backed state store - TUI dashboard with split-pane layout (sessions, output, metrics) - Worktree orchestration (auto-create per agent session) - Observability with tool call risk scoring - Inter-agent communication via SQLite mailbox - Background daemon with heartbeat monitoring - CLI with start/stop/sessions/status/daemon subcommands Tech stack: Rust + Ratatui + Crossterm + Tokio + rusqlite + git2 + clap	2026-03-22 15:48:19 -07:00