Installation

Installation

Prerequisites

  • Node.js 20 or higher — Athena Flow requires modern Node.js APIs. Run node --version to check.
  • git — Required to resolve plugins and workflows from marketplace repositories.
  • Claude Code — Athena wraps Claude Code's hook system. Install and authenticate Claude Code before using Athena.
  • npm (comes with Node.js) — used for the global install.

Install

npm install -g @athenaflow/cli

This installs three binaries:

athena                  # short alias
athena-flow             # full command name
athena-hook-forwarder   # internal hook bridge (called by Claude Code hooks)

athena and athena-flow are identical entry points — use whichever you prefer.

Verify the Installation

athena --version

Updating

npm update -g @athenaflow/cli

Platform Support

Athena Flow runs on macOS and Linux. On Windows, WSL is recommended due to Unix Domain Socket usage.