ACK

Agent Config Keeper
Your AI agent's toolbox, managed from where you already work.

Agent tools are scattered across JSON files in hidden directories. You add an MCP server here, a slash command there, tweak a permission somewhere else -- and none of it is visible until something breaks.

ACK puts it all in one place. Browse, install, toggle, and organize every tool your AI agent uses -- without ever opening a config file. Switch between Claude Code and Codex with a single click.

ACK sidebar showing the tool tree with MCP servers, slash commands, and hooks organized by scope
_{The tool tree surfaces everything your agent can reach -- grouped, scoped, and one click away.}

What ACK Does

Switch between agents

ACK detects your installed agents (Claude Code and Codex) and lets you switch between them from the status bar or command palette. The sidebar, marketplace, and config panel all context-switch to show the active agent's tools.

See everything at a glance

The sidebar tree discovers your full agent configuration automatically. MCP servers, slash commands, hooks, and skills are grouped by type and labeled by scope (user vs. project) so you always know what's active and where it lives.

Install tools without leaving the editor

ACK marketplace panel browsing community tools
_{Browse the community registry, read descriptions, and install to user or project scope in one click.}

The built-in marketplace connects to a community tool registry. Search, filter by type, read details, and install -- all from a webview panel inside VS Code. No terminal, no manual JSON editing.

Switch contexts with profiles

Different projects need different tool setups. Profiles let you snapshot your current configuration and restore it later with a single command. Profiles are scoped per agent -- each agent maintains its own profile set.

Save as profile -- Freeze your current tools, servers, and settings into a named snapshot
Import / Export -- Share configurations as portable JSON files with agent compatibility metadata
Workspace association -- Bind a profile to a workspace so it activates the moment you open it
Clone to agent -- Copy a profile from one agent to another, filtering to compatible tools

Profile switcher showing named configurations
_{Switch between tool setups as easily as switching Git branches.}

Configure your agent visually

ACK config panel with model, permissions, and custom instructions
_{Edit model, permissions, and custom instructions through a form -- no JSON required.}

Open the config panel from the command palette (ACK: Configure Agent) to edit Claude Code settings through a proper UI. Model selection, permission levels, custom instructions, and MCP server configuration are all form fields instead of raw JSON.

Organize and control inline

Every tool in the tree has inline actions:

Toggle -- Enable or disable a tool without removing it
Move -- Shift a tool between user and project scope
Delete -- Remove a tool with optional confirmation

Right-click any tool for the full context menu.

Quick Start

1.  Install from the marketplace        code --install-extension koenrohrer.ack
2.  Open the ACK sidebar                Click the ACK icon in the activity bar
3.  Browse your tools                   The tree auto-discovers your config
4.  Install something new               Click the marketplace icon in the title bar

Commands

All commands are available from the command palette (Ctrl+Shift+P / Cmd+Shift+P).

Command	Description
`ACK: Open Marketplace`	Browse and install tools from the community registry
`ACK: Configure Agent`	Open the visual config panel
`ACK: Switch Agent`	Switch the active agent (Claude Code / Codex)
`ACK: Initialize Codex for This Project`	Scaffold `.codex/config.toml`, `prompts/`, and `skills/`
`ACK: Re-detect Agents`	Re-run agent detection after installing a new CLI
`ACK: Switch Profile`	Switch to a saved profile
`ACK: Create Profile`	Create a new empty profile
`ACK: Save Current State as Profile`	Snapshot current tools as a profile
`ACK: Edit Profile`	Modify an existing profile
`ACK: Delete Profile`	Remove a profile
`ACK: Export Profile`	Export a profile to a `.ackprofile` file
`ACK: Import Profile`	Import a profile from a `.ackprofile` file
`ACK: Clone Profile to Agent`	Copy a profile to another agent, filtering compatible tools
`ACK: Associate Profile with Workspace`	Bind a profile to auto-activate for this workspace
`ACK: Install Custom Prompt from File`	Copy a `.md` file into Codex's prompts directory
`ACK: Refresh Tool Tree`	Force-refresh the sidebar tree

Settings

Configure ACK behavior in VS Code settings (Ctrl+, / Cmd+,).

Setting	Type	Default	Description
`ack.showChangeNotifications`	`boolean`	`true`	Notify when agent config files are modified outside VS Code
`ack.skipDeleteConfirmation`	`boolean`	`false`	Skip the confirmation dialog when deleting tools
`ack.autoActivateWorkspaceProfiles`	`boolean`	`true`	Automatically activate the associated profile when opening a workspace
`ack.userRepositories`	`string[]`	`[]`	GitHub repository URLs to scan for installable tools
`ack.registrySources`	`object[]`	`[]`	Additional tool registry sources (GitHub repos). The default community registry is always included.

Custom Registry Sources

Add your own tool registries by configuring ack.registrySources:

"ack.registrySources": [
  {
    "id": "my-team",
    "name": "Team Tools",
    "owner": "my-org",
    "repo": "agent-tools",
    "branch": "main",             // optional, defaults to "main"
    "indexPath": "registry.json"  // optional, defaults to "registry.json"
  }
]

Supported Agents

Agent	Config format	Tool types
Claude Code	JSON (`~/.claude/`, `.claude/`)	MCP servers, slash commands, hooks, skills
Codex	TOML (`~/.codex/`, `.codex/`)	MCP servers, skills, custom prompts

ACK auto-detects which agents are installed. If both are present, a status bar item lets you switch between them. Each agent has its own sidebar view, marketplace filter, and profile set.

Architecture at a Glance

┌─────────────────────────────────────────┐
│  VS Code Extension Host                 │
│                                         │
│  ┌─────────────┐   ┌────────────────┐  │
│  │  Tool Tree   │   │  File Watcher  │  │
│  │  (sidebar)   │   │  (live reload) │  │
│  └──────┬───────┘   └───────┬────────┘  │
│         │                   │           │
│  ┌──────┴───────────────────┴────────┐  │
│  │       Adapter Registry            │  │
│  │  ┌────────────────────────────┐   │  │
│  │  │  Claude Code Adapter       │   │  │
│  │  │  parsers / writers / paths │   │  │
│  │  └────────────────────────────┘   │  │
│  │  ┌────────────────────────────┐   │  │
│  │  │  Codex Adapter             │   │  │
│  │  │  TOML parsers / writers    │   │  │
│  │  └────────────────────────────┘   │  │
│  └───────────────────────────────────┘  │
│                                         │
│  ┌──────────────┐   ┌───────────────┐   │
│  │  Marketplace  │   │ Config Panel  │   │
│  │  (webview)    │   │  (webview)    │   │
│  └──────────────┘   └───────────────┘   │
└─────────────────────────────────────────┘

Privacy

ACK reads and writes agent configuration files on your local machine. It does not collect telemetry, phone home, or transmit any data. Marketplace browsing fetches public registry files from GitHub.

Contributing

See CONTRIBUTING.md for setup instructions and guidelines.

License

MIT -- Koen Rohrer

ACK - Agent Config Keeper

Koen Rohrer

ACK