CLI Reference

Dexicon CLI (dexicon) is a tool to discover, parse, and upload AI coding assistant session logs to Dexicon for search and analysis.

Installation

Using Homebrew (macOS/Linux):

brew install Dexicon-AI/tap/dexicon

Using curl (macOS/Linux):

curl -sSL https://raw.githubusercontent.com/Dexicon-AI/get-dexicon-cli/main/install.sh | sh

Using PowerShell (Windows):

irm https://raw.githubusercontent.com/Dexicon-AI/get-dexicon-cli/main/install.ps1 | iex

Commands

dexicon sync

Upload AI coding sessions for the current directory to Dexicon. Only sessions associated with the current folder/git repo will be synced.

dexicon sync [options]

Options:

Option	Description
--days DAYS	Number of days to sync (default: 30)
--force	Re-upload sessions even if already uploaded
--reset-ledger	Clear upload history before syncing
--first-time-flow	Treat as first sync (show onboarding prompts)
--debug	Show verbose per-session processing details
--dry-run	Show what would be synced without uploading
--no-claude	Disable Claude Code ingestion
--no-cursor	Disable Cursor ingestion
--no-vscode	Disable VS Code ingestion
--no-copilot	Disable GitHub Copilot CLI ingestion
--no-codex	Disable Codex CLI ingestion
--only-claude	Upload only Claude Code sessions
--only-cursor	Upload only Cursor sessions
--only-vscode	Upload only VS Code sessions
--only-copilot	Upload only GitHub Copilot CLI sessions
--only-codex	Upload only Codex CLI sessions
--all	Sync all registered repositories (for scheduled/batch syncs)
--trigger TRIGGER	Log trigger source (e.g., 'cron' for scheduled syncs)

Examples:

# Sync last 30 days (default)
dexicon sync

# Sync last 7 days
dexicon sync --days 7

# Preview what would be synced
dexicon sync --dry-run

# Re-upload all sessions
dexicon sync --force

# Sync only Claude Code sessions
dexicon sync --only-claude

# Sync all registered repos (useful for cron jobs)
dexicon sync --all --trigger cron

---

dexicon init

Initialize configuration and discover IDE logs. Sets up source paths, registers repositories, and optionally enables automatic syncing.

dexicon init [options]

Options:

Option	Description
--dry-run	Show what would be configured without making changes
--skip-repos	Skip repository registration and schedule setup
--repos-dir DIR	Directory to scan for repos (non-interactive, can repeat)
--auto-enable-schedule	Enable automatic syncing (non-interactive)

Examples:

# Interactive setup
dexicon init

# Preview configuration changes
dexicon init --dry-run

# Non-interactive setup with specific directories
dexicon init --repos-dir ~/projects --repos-dir ~/work --auto-enable-schedule

---

dexicon login

Log in to Dexicon via browser using device authorization flow.

dexicon login [options]

Options:

Option	Description
--force	Re-authenticate even if already logged in

Examples:

# Log in (opens browser)
dexicon login

# Force re-authentication
dexicon login --force

---

dexicon discover

Show detected AI coding agent chat locations. Displays paths where session data was found for Claude Code, Cursor, VS Code, Copilot CLI, and Codex CLI.

dexicon discover

Example output:

Detected AI coding agent locations:
  Claude Code: ~/.claude/projects
  Cursor: ~/Library/Application Support/Cursor/User/workspaceStorage
  VS Code: ~/Library/Application Support/Code/User/workspaceStorage
  Copilot CLI: ~/.local/share/gh-copilot
  Codex CLI: ~/.codex/sessions

---

dexicon add-agent-instructions

Append Dexicon MCP instructions to AGENTS.md and/or CLAUDE.md files in the current directory.

dexicon add-agent-instructions [options]

Options:

Option	Description
--dry-run	Show what would be updated without writing files

Examples:

# Add instructions to agent config files
dexicon add-agent-instructions

# Preview changes
dexicon add-agent-instructions --dry-run

---

dexicon stats

Show session statistics for the current directory.

dexicon stats [options]

Options:

Option	Description
--days DAYS	Number of days to analyze (default: 30)

Examples:

# Show stats for last 30 days
dexicon stats

# Show stats for last 7 days
dexicon stats --days 7

---

dexicon clean

Delete all exported sessions.

dexicon clean [options]

Options:

Option	Description
--force	Skip confirmation prompt

Examples:

# Delete with confirmation
dexicon clean

# Delete without confirmation
dexicon clean --force

---

dexicon config

View or update IDE log paths and settings.

dexicon config [options]

Options:

Option	Description
--cursor-path PATH	Manual path to Cursor logs
--claude-code-path PATH	Manual path to Claude Code logs
--copilot-cli-path PATH	Manual path to Copilot CLI session transcripts
--vscode-storage PATH	Manual path to VS Code workspaceStorage directory
--codex-path PATH	Manual path to Codex CLI sessions directory
--api-key API_KEY	Legacy API key (prefer dexicon login instead)

Examples:

# View current configuration
dexicon config

# Set custom Claude Code path
dexicon config --claude-code-path ~/custom/claude/path

# Set custom Cursor path
dexicon config --cursor-path ~/custom/cursor/path

---

dexicon mcp setup

Configure MCP (Model Context Protocol) for coding agents like Claude Code and Cursor.

dexicon mcp setup

This interactive command helps you set up MCP integration with your preferred coding agent. For detailed MCP configuration, see the MCP Server documentation.

---

dexicon repos

Manage the repository registry for automatic syncing.

dexicon repos list

List all registered repositories.

dexicon repos list

dexicon repos add

Add a repository to the sync registry.

dexicon repos add <path>

Example:

dexicon repos add ~/projects/my-app

dexicon repos remove

Remove a repository from the registry (by path or remote URL).

dexicon repos remove <target>

Examples:

# Remove by path
dexicon repos remove ~/projects/my-app

# Remove by remote URL
dexicon repos remove git@github.com:user/my-app.git

dexicon repos scan

Scan a directory for git repositories and register them.

dexicon repos scan <directory> [options]

Options:

Option	Description
--auto-add	Register all found repos without prompting

Examples:

# Interactive scan
dexicon repos scan ~/projects

# Auto-register all found repos
dexicon repos scan ~/projects --auto-add

---

dexicon schedule

Manage automatic syncing schedules.

dexicon schedule enable

Enable automatic syncing via launchd (macOS), cron (Linux), or Task Scheduler (Windows).

dexicon schedule enable

dexicon schedule disable

Disable automatic syncing.

dexicon schedule disable

dexicon schedule status

Show current scheduling status, next run time, and recent sync activity.

dexicon schedule status

dexicon schedule logs

Show sync history.

dexicon schedule logs [options]

Options:

Option	Description
-n, --limit LIMIT	Number of log entries to show (default: 20)

Examples:

# Show last 20 sync logs
dexicon schedule logs

# Show last 50 sync logs
dexicon schedule logs --limit 50

---

Global Options

These options are available for all commands:

Option	Description
-h, --help	Show help message
--version, -v	Show version information

Examples:

# Show CLI version
dexicon --version

# Show help for a specific command
dexicon sync --help

---

Common Workflows

First-time Setup

# 1. Install the CLI
brew install Dexicon-AI/tap/dexicon

# 2. Initialize and discover IDE logs
dexicon init

# 3. Log in to Dexicon
dexicon login

# 4. Sync your first sessions
cd ~/your-project
dexicon sync

Daily Usage

# Sync sessions at the end of each day
cd ~/your-project
dexicon sync

Automated Syncing

# Register your repositories
dexicon repos scan ~/projects --auto-add

# Enable automatic syncing
dexicon schedule enable

# Check sync status
dexicon schedule status

Troubleshooting

# Check detected IDE locations
dexicon discover

# Preview what would be synced
dexicon sync --dry-run

# View detailed sync output
dexicon sync --debug

# Clear upload history and re-sync
dexicon sync --reset-ledger