imdone-cli

Turn your issue tracker into shared working memory.

Connect Jira or GitHub, inspect the local Markdown files imdone creates, make one update, and push it back without leaving your editor.

Read CLI docs npm package

Before you start

macOS arm64 users can use the standalone installer below; it includes the runtime.
Node.js 22 or newer if you install from npm.
git and a project directory. Run imdone init from your repo.
Jira or GitHub access with permission to read and update issues.

The package is imdone-cli. It installs the imdone command.

macOS download

Download the macOS arm64 DMG, run the pkg inside it, then verify the installed imdone command from Terminal.

Standalone pkg for macOS arm64

Installs imdone-cli under /usr/local/lib/imdone-cli and exposes /usr/local/bin/imdone. The npm path below remains available for other platforms and developers who already use Node.

Download macOS pkg npm fallback

Version: 0.78.1
Artifact: imdone-cli-0.78.1-darwin-arm64.dmg

If macOS blocks the installer because it is not signed or notarized yet, use the npm fallback while the standalone release path is finalized.

Install and Sync

Start in the repo where issue context should live. imdone will create local backlog files and sync them with Jira or GitHub. Use this npm path when you already have Node installed or are not on macOS arm64.

What appears in your repo

imdone stores issue content, comments, attachments, and sync metadata as local files you can inspect with your editor, grep, diffs, and AI coding agents.

>tree backlog
backlog
├── .imdone
│   └── config.yml
└── current-sprint
    └── SCRUM-123-Example_issue
        ├── attachments
        │   └── .metadata.yml
        ├── comments-SCRUM-123.md
        ├── issue-SCRUM-123.md
        └── changelog.yml

System metadata lives in HTML comments at the end of issue files. Leave it intact so imdone can map local files back to provider issues.

Open the generated Markdown, make one small edit, then push it back.

Sync commands

Read provider context

imdone pull fetches issues, comments, and attachments.
imdone show KEY inspects one issue.
imdone list lists local issues.

Write local changes

imdone push syncs local Markdown updates back.
imdone add creates a new issue.
imdone move KEY "In Progress" changes status.
imdone merge resolves sync conflicts locally.
imdone docs opens the imdone-cli docs in your browser.

Where to go next

Use the full CLI docs for provider setup, command reference, Git behavior, attachments, AI skills, and troubleshooting.

Open CLI docs Troubleshooting