COGMINT

Dark-first control plane for Claude Code orchestration.

Quick Start · Features · UI Preview · Roadmap · Contributing

---

Why COGMINT

COGMINT turns Claude Code management from a config-file maze into a visual operating surface.

• Build and manage multi-agent systems faster
• Control skills, commands, workflows, and plugins from one UI
• Track sessions and execution context with less friction
• Keep customization local to your own .claude workspace

---

Quick Start

git clone https://github.com/ThanhNguyxnOrg/cogmint.git
cd cogmint
bun install
bun run dev

Open http://localhost:3000.

Requirements: Bun (recommended) or Node.js 18+.

Optional: Install via Claude Plugin Marketplace

You can also install COGMINT as a Claude Code plugin and run it with /cogmint.

1. Add marketplace source:

/plugin marketplace add ThanhNguyxnOrg/cogmint

2. Install plugin from marketplace:

/plugin install cogmint@cogmint-marketplace

3. Start COGMINT:

/cogmint

If launcher command is missing after install, run OS-specific installer once:

# Windows
pwsh -NoProfile -ExecutionPolicy Bypass -File "$PWD/scripts/distribution/install-cogmint.ps1"

# macOS / Linux
bash "$PWD/scripts/distribution/install-cogmint.sh"

Then run again:

/cogmint

---

Features

1) Agent Orchestration Workspace

Design, organize, and edit agents visually instead of hand-editing markdown everywhere.

• Agent metadata + model setup
• Prompt/instruction editing
• Memory and behavior controls

---

2) Chat + Studio Testing Loop

Test behavior quickly with a live interface.

• Real-time iteration
• Tool/event visibility
• Faster debugging cycle

---

3) Workflow and Relationship Mapping

Understand and operate your system topology.

• Workflow builder for multi-step execution
• Relationship graph for connected entities

---

4) Skill and Plugin Operations

Scale your local ecosystem with better control.

• Skill import and management
• Plugin visibility and toggles
• Better discoverability via Explore

---

UI Preview

COGMINT uses a dark-first cobalt/violet design system for long sessions and reduced eye strain.

Brand assets included in public/:

• favicon.svg, favicon.ico
• favicon-16x16.png, favicon-32x32.png
• apple-touch-icon.png
• icon-192.png, icon-512.png
• site.webmanifest

---

i18n (English-first)

Current baseline:

• English default (en)
• Locale field persisted in settings (settings.locale)
• Vietnamese translation coverage across core and detail pages

Language selector is available in Settings.

---

Tech Stack

• Nuxt 3 + Vue 3
• Nuxt UI + Tailwind CSS
• VueFlow
• Bun runtime
• TypeScript

---

Environment Variables

Variable	Description	Default
CLAUDE_DIR	Path to your Claude config directory	~/.claude
CLAUDE_CLI_PATH	Optional explicit path to Claude CLI executable	Auto-detected

---

Roadmap

• Full i18n coverage across all pages
• GIF demo walkthroughs for README
• Theme presets and workspace personalization packs
• Extended test harness for workflow simulation

---

Contributing

See CONTRIBUTING.md.

---

License

MIT — see LICENSE.