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.

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

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.

Save as profile -- Freeze your current tools, servers, and settings into a named snapshot
Import / Export -- Share configurations as portable JSON files
Workspace association -- Bind a profile to a workspace so it activates the moment you open it

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 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 JSON file
`ACK: Import Profile`	Import a profile from a JSON file
`ACK: Associate Profile with Workspace`	Bind a profile to auto-activate for this workspace
`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

ACK v1.0 is built for Claude Code. The adapter architecture is designed to support additional agents in the future -- the internal API already separates parsing, writing, and schema validation per agent.

Architecture at a Glance

┌─────────────────────────────────────────┐
│  VS Code Extension Host                 │
│                                         │
│  ┌─────────────┐   ┌────────────────┐  │
│  │  Tool Tree   │   │  File Watcher  │  │
│  │  (sidebar)   │   │  (live reload) │  │
│  └──────┬───────┘   └───────┬────────┘  │
│         │                   │           │
│  ┌──────┴───────────────────┴────────┐  │
│  │       Adapter Registry            │  │
│  │  ┌────────────────────────────┐   │  │
│  │  │  Claude Code Adapter       │   │  │
│  │  │  parsers / writers / paths │   │  │
│  │  └────────────────────────────┘   │  │
│  └───────────────────────────────────┘  │
│                                         │
│  ┌──────────────┐   ┌───────────────┐   │
│  │  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