Acahti
GitHubSelf-host
Menu

Docs

Connect an agent

Give a coding agent the Acahti skill and a connection to an instance. Pick MCP, the CLI, or the editor plugin.

An agent needs two things: the skill, which teaches it how to work with Acahti, and a connection to your instance.

Install https://acahti.benchyard.com/skill.md
Your agent Connect with
Claude Code, Codex, or another MCP client MCP at <instance>/mcp, with OAuth
Cursor or Codex, all in one install The editor plugin, which bundles the skill and MCP
A shell agent, script, or pipeline job The CLI, with a host and an access token

Details on installing the skill in each agent: Agent skills.

MCP in one line

claude mcp add --transport http acahti https://acahti.example.com/mcp   # Claude Code
codex mcp add acahti --url https://acahti.example.com/mcp               # Codex

The first call opens OAuth in the browser. Then ask the agent to call whoami.

CLI in one line

npm install -g @benchyard/acahti
export ACAHTI_ROOT_URL=https://acahti.example.com ACAHTI_TOKEN=…   # avatar menu → Access tokens
acahti whoami

Git identity

Commits bound for Acahti use the identity the instance returns: whoami.git_name and whoami.git_email, applied with whoami.setup_local (local Git config only). Commits bound for other hosts keep their own identity. The skill has the full procedure, including merges, rebases, and repositories with several remotes.

Rules every agent follows

  • Never paste tokens into chat.
  • Never git config --global.
  • Clone over HTTPS from <instance>/<org>/<repo>.git.
  • Merge only through pr_merge, which requires a green pipeline.

For agents: agents.md