Documentation

Everything you need to transform AI conversations into production-ready code.

Quick Start

1. Install UCTS

pip install ucts

2. Analyze a conversation

ucts analyze conversation.json

3. Forge your project

ucts forge ./my-project --vscode --gitlab

Explore the Docs

Getting Started

Installation, first project, and basic concepts.

CLI Reference

Complete command reference and examples.

API Reference

REST API and WebSocket documentation.

Generators

VS Code, GitLab CI, GitHub Actions, and more.

Architecture

Design decisions and internal architecture.

Deployment

Docker, Kubernetes, and cloud deployment.

CLI Commands

ucts analyze

Analyze AI conversation files and extract context.

ucts analyze <file> [options]

Options:
  --format, -f    Output format (json, yaml, text)
  --output, -o    Output file path
  --verbose, -v   Verbose output
  --quiet, -q     Minimal output

Examples

# Analyze a Claude Desktop conversation
ucts analyze ~/.claude/conversations/latest.json

# Analyze with JSON output
ucts analyze chat.json --format json --output analysis.json

# Analyze VS Code Copilot session
ucts analyze .copilot/session.json

ucts forge

Generate project structure and configuration files.

ucts forge <output-dir> [options]

Options:
  --vscode        Generate VS Code workspace config
  --gitlab        Generate GitLab CI pipeline
  --github        Generate GitHub Actions workflow
  --k8s           Generate Kubernetes manifests
  --all           Generate all configurations
  --template, -t  Use a custom template
  --dry-run       Preview without writing files

Examples

# Generate VS Code and GitLab config
ucts forge ./my-project --vscode --gitlab

# Generate everything
ucts forge ./my-project --all

# Preview what would be generated
ucts forge ./my-project --all --dry-run

# Use a custom template
ucts forge ./my-project --template python-fastapi

ucts stats

View session statistics and usage metrics.

ucts stats [options]

Options:
  --all           Show all sessions
  --recent        Show recent sessions (default)
  --format, -f    Output format (table, json)

Supported Platforms

VS Code

Full workspace configuration

GitLab

CI/CD pipeline generation

GitHub

Actions workflow generation

Kubernetes

Manifest generation

Need Help?

We're here to help you succeed with UCTS.

Community

Ask questions on GitHub Discussions

Discord

Chat with the community

Report Issues

Found a bug? Let us know