v0.1.0 — Latest Release

Get Started with TraceVault

Install the CLI, deploy the server, and start tracing AI-assisted development.

CLI Installation

Choose your preferred method

Cargo (Rust)

cargo install tracevault-cli

Requires Rust toolchain installed.

Homebrew (macOS / Linux)

brew install softwaremill/tracevault/tracevault

Pre-built Binaries

Download pre-compiled binaries for your platform from GitHub Releases.

GitHub Releases

Server Setup

Deploy with Docker Compose

Generate an encryption key, then start the server with PostgreSQL:

export TRACEVAULT_ENCRYPTION_KEY=$(openssl rand -base64 32)

Save this docker-compose.yml and run docker compose up -d:

services:
  db:
    image: postgres:16
    environment:
      POSTGRES_DB: tracevault
      POSTGRES_USER: tracevault
      POSTGRES_PASSWORD: tracevault
    ports:
      - "5432:5432"
    volumes:
      - pgdata:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U tracevault"]
      interval: 5s
      timeout: 5s
      retries: 5

  server:
    image: ghcr.io/softwaremill/tracevault-server:latest
    depends_on:
      db:
        condition: service_healthy
    environment:
      DATABASE_URL: postgres://tracevault:tracevault@db:5432/tracevault
      HOST: 0.0.0.0
      PORT: 3000
      RUST_LOG: info
      TRACEVAULT_ENCRYPTION_KEY: ${TRACEVAULT_ENCRYPTION_KEY}
    ports:
      - "3000:3000"

volumes:
  pgdata:

The server will be available at http://localhost:3000. Connect the CLI with:

tracevault login --server_url http://localhost:3000

Next steps

Learn about the CLI commands, server configuration, and CI/CD integration.

CLI Reference Server Docs