CleverCase

Developer Onboarding

Full per-developer setup for the CleverCase team — from clone to first successful build.

CleverCase Developer Onboarding

Per-developer setup for the CleverCase team (not platform operators).

Your team lead will provide a Tailscale auth key and AWS credentials. Once you have those:

# 1. Clone the repo
git clone git@github.com:rakontevr-ai/clevercase-v2.git
cd clevercase-v2

# 2. Install all dependencies (Brewfile: Node, Colima, Docker, kubectl, Tailscale, Cursor)
brew bundle install --file=Brewfile

# 3. Bootstrap (joins Tailscale, starts Colima, npm install, clevercase setup)
./scripts/bootstrap-developer.sh --tailscale-key tskey-auth-XXXX

# 4. Add AWS credentials (~/.aws/credentials) — team lead provides separately

# 5. Refresh package access and install
npm run setup:codeartifact
npm install

# 6. Pull secrets and start
npx clevercase secrets pull
npx clevercase start

# 7. Verify
./scripts/verify-setup.sh
npx clevercase doctor

Use --minimal on 16GB Macs: ./scripts/bootstrap-developer.sh --minimal --tailscale-key …

Brewfile (what gets installed)

CategoryPackages
Corenode@24, git, git-lfs, jq, awscli, gh, wget
Containerscolima, docker, docker-compose, docker-buildx
Kuberneteskubernetes-cli (kubectl)
DB clientslibpq (psql), redis
DesktopTailscale, Cursor

The bootstrap script handles Colima start, Docker CLI plugins, and PATH for keg-only formulae.

What You Need From Your Team Lead

ItemHow you get it
GitHub accessTeam lead adds you to rakontevr-ai/clevercase-v2
Tailscale keytskey-auth-... (one-time, expires 24h)
AWS credentialsAccess key + secret (for @rakontevr packages)
Secrets accessGranted after clevercase secrets pull

Manual Setup (if bootstrap doesn't fit)

Prerequisites

  • macOS 13+ (Apple Silicon or Intel)
  • Node.js 24+ (brew install node@24)
  • Git + SSH access to rakontevr-ai/clevercase-v2
  • Tailscale (brew install --cask tailscale)
  • Cursor IDE (brew install --cask cursor)
  • AWS CLI (brew install awscli)

Steps

  1. Clone: git clone git@github.com:rakontevr-ai/clevercase-v2.git && cd clevercase-v2
  2. Join Tailscale: sudo tailscale up --auth-key=<key> --accept-routes
  3. Configure CodeArtifact: npm run setup:codeartifact
  4. Install: npm install
  5. Setup CLI: npx clevercase setup
  6. Pull secrets: npx clevercase secrets pull
  7. Start: npx clevercase start
  8. Verify: npx clevercase doctor

Cursor IDE + MCP

clevercase setup configures the Rakontevr MCP server with tenant scope. This gives you:

  • AI assistance scoped to CleverCase domain
  • Compliance rules auto-loaded
  • Code completion with legal domain context

Verify: npx clevercase doctor

Network Access (Tailscale)

ResourceAccess
CleverCase services✅ ports 443, 8443, 3000, 5432
Gravislaw services✅ all ports
DGX cluster❌ proxied only (via service layer)
AWS infrastructure❌ proxied only

Docs

What you should NOT do

  • Run rak db safe-migrate from client repo (platform operators only)
  • Import paths outside clevercase-v2/ in standalone builds
  • Log case narratives, client PII, or document bodies
  • Share your Tailscale auth key with others (one key per person)

Troubleshooting

ProblemFix
npm install fails with 401Run npm run setup:codeartifact (AWS token expired)
Tailscale "not connected"sudo tailscale up --auth-key=<key> --accept-routes
clevercase secrets pull deniedAsk team lead to grant your email access
Cursor MCP not workingnpx clevercase setup then restart Cursor

On this page