> ## Documentation Index > Fetch the complete documentation index at: https://agentlogs.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # Commands > Complete CLI command reference # Command Reference ## Authentication ### login Authenticate with AgentLogs using device authorization. ```bash theme={null} npx agentlogs login ``` Examples: ```bash theme={null} npx agentlogs login agentlogs.ai npx agentlogs login localhost:3000 ``` The hostname is required. The CLI opens a browser for authentication and stores your token locally for that host. ### logout Remove stored authentication credentials. ```bash theme={null} npx agentlogs logout [hostname] ``` * With a hostname, logs out only from that host. * Without a hostname, logs out from all configured hosts. ### status Show current authentication status and account info. ```bash theme={null} npx agentlogs status ``` **Output (example):** ``` 🔐 AgentLogs Authentication Status agentlogs.ai (https://agentlogs.ai) ✅ Logged in 👤 Example User 📧 user@example.com ``` *** ## Upload ### upload Interactively browse and upload transcripts from any agent (Claude Code, Codex, OpenCode, Pi). ```bash theme={null} npx agentlogs upload [directory] [options] ``` **Arguments:** * `directory` - Optional. Filter to transcripts from this directory **Options:** * `-s, --source ` - Filter by source: `claude-code`, `codex`, `opencode`, or `pi` * `-l, --latest` - Upload the most recent transcript without showing picker **Behavior:** * Discovers transcripts from all installed agents * Shows an interactive picker to select a transcript * Displays time, source, directory, and preview for each transcript * Uploads the selected transcript **Examples:** ```bash theme={null} # Interactive picker with all transcripts npx agentlogs upload # Only show transcripts from current directory npx agentlogs upload . # Only show Claude Code transcripts npx agentlogs upload --source claude-code # Upload most recent transcript without picker npx agentlogs upload --latest # Upload most recent from current directory npx agentlogs upload . --latest ``` *** ## Claude Code ### claudecode sync Sync all local Claude Code transcripts to AgentLogs. ```bash theme={null} npx agentlogs claudecode sync [claudeDir] ``` **Arguments:** * `claudeDir` - Optional. Path to Claude data directory. Defaults to `~/.claude` **Options:** * `--cwd ` - Only upload transcripts from sessions in a specific working directory **Behavior:** * Scans for transcript files in the Claude directory * Skips already-uploaded transcripts (deduplication via SHA256) * Respects your allow/deny settings **Example:** ```bash theme={null} # Sync all transcripts npx agentlogs claudecode sync # Only sync transcripts from a specific project npx agentlogs claudecode sync --cwd /path/to/my-project ``` ### claudecode upload Upload a specific transcript file. ```bash theme={null} npx agentlogs claudecode upload ``` **Arguments:** * `transcript` - Path to the JSONL transcript file ### claudecode hook Hook entry point for Claude Code integration. Called automatically by Claude Code hooks. ```bash theme={null} npx agentlogs claudecode hook ``` Reads hook data from stdin. This command is meant to be called from Claude Code's hook system, not manually. *** ## Codex ### codex upload Upload a Codex transcript file. ```bash theme={null} npx agentlogs codex upload ``` **Arguments:** * `transcript` - Path to the JSONL transcript file **Example:** ```bash theme={null} npx agentlogs codex upload ~/.codex/sessions/2025/01/25/session-abc123.jsonl ``` ### codex hook Hook entry point for Codex integration. Called automatically by Codex hooks. ```bash theme={null} npx agentlogs@latest codex hook ``` Reads hook data from stdin. This command is meant to be called from Codex's hook system, not manually. ### codex install Install the AgentLogs Codex hook integration into `~/.codex`. ```bash theme={null} npx agentlogs codex install ``` This command: * Enables `codex_hooks` in `~/.codex/config.toml` * Writes AgentLogs hook entries to `~/.codex/hooks.json` * Prefers `AGENTLOGS_CLI_PATH` when set, otherwise runs `npx -y agentlogs@latest codex hook` * Captures transcripts only; git commit tracking hooks are not installed by default *** ## OpenCode ### opencode upload Upload an OpenCode session. ```bash theme={null} npx agentlogs opencode upload ``` **Arguments:** * `sessionId` - The OpenCode session ID to upload Sessions are read from `~/.local/share/opencode/storage/`. **Example:** ```bash theme={null} npx agentlogs opencode upload ses_abc123def456 ``` ### opencode hook Hook entry point for OpenCode plugin integration. Called automatically by the OpenCode plugin. ```bash theme={null} npx agentlogs opencode hook ``` Reads hook data from stdin and outputs JSON response. This command handles: * **tool.execute.before** - Intercepts git commits to add transcript links * **tool.execute.after** - Tracks commit metadata (SHA, branch, title) * **session.idle** - Uploads the complete transcript This command is meant to be called from the OpenCode plugin, not manually. *** ## Pi ### pi upload Upload a Pi session transcript. ```bash theme={null} npx agentlogs pi upload [sessionIdOrPath] ``` **Arguments:** * `sessionIdOrPath` - Optional. Session ID or path to session file **Behavior:** * With no argument: lists recent Pi sessions * With session ID: finds and uploads that session * With file path: uploads the specified JSONL file Sessions are read from `~/.pi/agent/sessions/`. **Examples:** ```bash theme={null} # List recent sessions npx agentlogs pi upload # Upload by session ID (partial match works) npx agentlogs pi upload abc123 # Upload by file path npx agentlogs pi upload ~/.pi/agent/sessions/--myproject--/2025-01-25_abc123.jsonl ``` ### pi hook Hook entry point for Pi extension integration. Called automatically by the Pi extension. ```bash theme={null} npx agentlogs pi hook ``` Reads hook data from stdin and outputs JSON response. This command handles: * **tool\_call** - Intercepts git commits to add transcript links * **tool\_result** - Tracks commit metadata (SHA, branch, title) * **agent\_end** - Uploads the transcript after each agent turn completes * **session\_shutdown** - Uploads the complete transcript This command is meant to be called from the Pi extension, not manually. *** ## Settings ### settings View or modify repository settings. ```bash theme={null} npx agentlogs settings [options] ``` **Options:** * `--mode ` - Set capture mode: `denylist` or `allowlist` * `--json` - Output settings as JSON **Example:** ```bash theme={null} # View current settings npx agentlogs settings # Switch to allowlist mode npx agentlogs settings --mode allowlist ``` ### allow Allow a repository to be captured. ```bash theme={null} npx agentlogs allow [options] ``` **Arguments:** * `path` - Path to the repository **Options:** * `--visibility ` - Set visibility: `private`, `team`, or `public` **Example:** ```bash theme={null} # Allow a repo with default visibility npx agentlogs allow /path/to/repo # Allow with explicit visibility npx agentlogs allow /path/to/repo --visibility private ``` ### deny Deny a repository from being captured. ```bash theme={null} npx agentlogs deny ``` **Arguments:** * `path` - Path to the repository **Example:** ```bash theme={null} npx agentlogs deny /path/to/secret-repo ``` *** ## Global Options These options work with any command: | Option | Description | | ----------- | ----------------------- | | `--help` | Show help for a command | | `--version` | Show CLI version | **Example:** ```bash theme={null} # Get help for a specific command npx agentlogs claudecode sync --help ```