Requirements

Confirm prerequisites before setup.

Requirements

  • git installed for normal git-coordinated pull/push workflows, except when using the macOS arm64 standalone artifact’s bundled Git fallback. npm installation and explicit pull-only refreshes with imdone pull --no-git do not require git.
  • For the macOS arm64 standalone artifact: no separate Node.js or npm install is required; the artifact bundles the Node.js runtime used by imdone and a private Git fallback used only when system Git is unavailable.
  • For npm installation: Node.js v22 or higher installed
  • For Jira:
    • Jira account with API access
    • A Jira API token with read and write permissions for the project
  • For GitHub:
    • GitHub account with repository access
    • A GitHub Personal Access Token: classic tokens need repo; fine-grained tokens need repository Contents: Read and write, Issues: Read and write, and Pull requests: Read and write
  • A git repository used for your software development (optional — imdone init works in any directory)