hack.foo

Agent integrations

With shell access, an agent can use the CLI directly. Complete Install, make the intended hack executable available on the agent's PATH, and give it this version's documentation index or full corpus. Plugins and MCP are optional additions. They do not install Hack or prepare its runtime.

v5 retired automatic instruction injection. Hack no longer writes AGENTS.md or CLAUDE.md sections, Cursor rules, session hooks or global skill copies, and the old hack setup sync and hack agent prime paths refuse with a retirement notice. Existing customized files are left alone. Guidance now arrives through the plugin below, which the client's own plugin manager installs and updates.

The hack plugin

The hack plugin ships eight skills and nothing else: no hooks, no rules, no MCP server.

SkillPurpose
hack-cliEveryday workflows: services, URLs, logs, exec and workspaces
hack-branchesParallel branch instances and aliases
hack-envEnv layers and value-safe configuration changes
hack-diagnoseRead-first diagnosis and the error-code reference
hack-initProject onboarding through the CLI's onboarding prompt
hack-installInstallation and executable or channel selection
hack-remotePrepare a project on another host or in a cloud environment
hack-feedbackReport a Hack problem with redacted evidence

Install it from this repository's marketplace:

# Codex
codex plugin marketplace add hack-dance/hack
codex plugin add hack@hack-dance

# Claude Code
claude plugin marketplace add hack-dance/hack --sparse .claude-plugin plugins/hack plugins/hack-mcp
claude plugin install hack@hack-dance

In Cursor, install Hack from Customize. The plugin finds hack on the client's PATH; during the prerelease that is whichever executable you put there. The plugin README has per-client notes. A plugin registered in a client is not proof that it loaded; check the client's plugin list.

The separate hack-mcp plugin

Clients without shell access can add hack-mcp. It declares one stdio server, hack mcp serve, and no skills. Use one Hack MCP registration per client, either this plugin or a single hack mcp install entry, never both. The MCP tools and MCP logs references describe the tool surface and its finite log cutoffs.

Project onboarding

hack agent onboard prints an onboarding prompt for an existing project, and hack init --with claude|codex hands a new project's setup to an agent. Both describe the work to do; neither installs skills or edits client configuration. See Explicit agent setup.


Source: v5 (next.12) · docs/site/integrations.md.

On this page