imdone-cli docs

Troubleshooting

Recover from auth, branch, license, merge, and provider sync issues.

Troubleshooting

Invalid License

Check your token:

imdone license --show

Jira Connection Issues

Ensure:

  • Jira URL is correct
  • API token is valid
  • You have permissions

Branch Issues

Stuck on the wrong branch:

If you find yourself on the main branch in your backlog directory, just run any imdone command and it will automatically switch you to imdone-work:

cd backlog
git branch  # Shows you're on 'main'
imdone pull  # Automatically switches to 'imdone-work' and continues

Want to see which branch you’re on:

cd backlog
git branch

The current branch will be marked with an asterisk (*).

Merge conflicts:

If you encounter merge conflicts in your backlog repository:

  1. Resolve conflicts in your editor
  2. Stage the resolved files: git add .
  3. Run: imdone merge

The automatic branch switching prevents most conflicts, but if multiple people work on the same issue simultaneously, conflicts can still occur.

Debug Mode

imdone-debug pull > debug.log

Use for support diagnostics.