imdone-cli docs

Workflow and git behavior

Use the daily pull, edit, push workflow and understand git behavior.

Core Commands

imdone pull     # Bring issues/comments/attachments into Markdown
imdone status   # See what's changed locally (alias: st)
imdone push     # Push your Markdown edits back to your provider
imdone push KEY # Push one issue without publishing other local changes
imdone hdd      # Launch Codex or Claude with HDD story context

Uninstall anytime: imdone destroy && npm uninstall -g imdone-cli (your code is untouched; backlog/ is git-ignored).

imdone-cli and Git

Imdone CLI uses git to make it easier for the rest of your team to get the project configured. Git is also used to track changes to your backlog files, so you can resolve conflicts and easily revert to previous versions if needed.

In most cases, you should let imdone-cli handle Git operations for you. It’s designed to commit and sync changes safely so you can stay focused on your work.

If you run into a Git conflict, just resolve it in your editor, then run imdone merge.

Automatic Branch Switching

To prevent accidental commits to the shared default branch (main), imdone-cli automatically manages branches in your backlog repository:

  • Working Branch: All backlog modifications happen on the imdone-work branch
  • Automatic Creation: The imdone-work branch is created automatically on first use
  • Seamless Switching: If you’re on main, commands like pull, push, add, update, merge, move, and reset will automatically switch to imdone-work
  • Visual Feedback: You’ll see a message when the branch switch happens: Switched to working branch 'imdone-work'

Special Cases:

  • imdone init and imdone clone commit initial setup to main branch first, then subsequent operations automatically switch to imdone-work
  • This ensures the foundational repository structure lives on the shared branch while all work happens on your working branch

Benefits:

  • Prevents merge conflicts when multiple team members work simultaneously
  • Keeps the default branch clean and stable
  • Makes collaboration smoother and safer