Context

Add session export/import commands to the CLI, enabling users to backup and share their session data as portable JSON files.

Implementation

• New kilocode export <sessionId> subcommand that exports session data to JSON
• New kilocode import <file> subcommand that previews exported session files
• Uses lightweight SessionClient + TrpcClient directly instead of full SessionManager initialization, allowing export to work as a standalone subcommand without starting the full CLI
• Token retrieval uses getKiloToken() with applyEnvOverrides() to support both config file and environment variable authentication
• Blob download failures are reported as warnings to stderr (export continues with partial data)

Exported data includes:

• Session metadata (title, mode, model, timestamps, git URL)
• API conversation history
• UI messages
• Task metadata
• Git state

How to Test

# Build the CLI
pnpm cli:bundle

# Export a session (get session ID from /session list in CLI)
cd cli && pnpm start export <session-id>

# Export to specific file
cd cli && pnpm start export <session-id> -o my-session.json

# Preview an exported session
cd cli && pnpm start import my-session.json

# Test error handling - invalid session ID
cd cli && pnpm start export invalid-id

# Test without token configured (should show helpful error)
KILOCODE_TOKEN= pnpm start export <session-id>

GitHub Copilot summary

This pull request adds new session export and import functionality to the CLI, enabling users to export session data to a JSON file and preview imports from such files. The changes introduce a new command implementation and integrate these commands into the CLI's command routing and help system.

Session export/import feature:

• Added a new module session-export.ts implementing session export to JSON, reading and validating exported sessions, and previewing imports. This includes fetching all relevant session data, handling blob URLs, and providing user warnings on errors.

CLI command integration:

• Registered new export and import commands in the CLI using Commander.js, with appropriate argument parsing, error handling, and user-facing messages.
• Updated the CLI's subcommand routing logic to recognize the new export and import commands, ensuring correct command dispatch.

Get in Touch

@PeterDaveHello