Syncing Sessions

How do I sync my sessions?

code-insights sync

Discovers sessions from all supported tools and syncs new or updated sessions to the local SQLite database. The first sync processes your entire history; subsequent syncs are incremental.

How do I sync from a specific tool?

code-insights sync --source claude-code
code-insights sync --source cursor
code-insights sync --source codex-cli
code-insights sync --source copilot-cli
code-insights sync --source copilot

How do I force a re-sync?

code-insights sync --force

Re-processes all sessions even if they haven't changed. Useful after a CLI update.

Dry run

code-insights sync --dry-run

Shows what would be synced without writing to the database.

Quiet mode

code-insights sync -q

Suppresses all output. Used by the auto-sync hook.

How do I set up auto-sync?

Install a hook that automatically syncs when a Claude Code session ends:

code-insights install-hook

To remove it:

code-insights uninstall-hook

The hook adds a Stop hook to ~/.claude/settings.json that runs code-insights sync -q after every Claude Code session.

Pruning trivial sessions

Sessions with 2 or fewer messages are likely abandoned prompts with no useful content. Use the prune command to soft-delete them:

code-insights sync prune

This shows a preview of all trivial sessions and asks for confirmation before making changes. Soft-deleted sessions:

• Do not appear in the dashboard, stats, or exports
• Remain in the database (not physically deleted)
• Can be restored by running code-insights sync --force

Troubleshooting

No sessions found — Check that your AI coding tool has been used and that session files exist in the expected location. Run code-insights status to see what the CLI has discovered.

SQLite locked error — Another process is using the database. Wait a moment and retry.