Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.tryardent.com/llms.txt

Use this file to discover all available pages before exploring further.

Prerequisites:
  • Node.js (LTS recommended)
  • A Postgres connection string (Supabase, RDS, PlanetScale, or self-hosted)
1

Install the CLI

npm install -g ardent-cli
2

Log in

ardent login
This opens your browser to authenticate with GitHub or email. If you only have one project and one connector, Ardent auto-selects them after login so you can go straight to ardent branch create.
3

Connect your database

ardent connector create postgresql 'postgresql://user:password@host:5432/mydb'
Wrap the URL in single quotes so special characters in the password or query string are not interpreted by the shell.Ardent replicates your database during initial setup. This may take some time depending on the size of your data — but you only do this once. After setup, every branch creates in under 6 seconds regardless of data size.
The new connector is automatically selected as your active connector.
4

Create your first branch

ardent branch create my-feature
Done. You now have an isolated copy of your production database. The CLI returns a connection string you can use anywhere — psql, your app, an ORM, or hand it to an agent.

​
What’s next

  • Feed the connection URL to Claude Code — test if your migration breaks, try a new index to see if it speeds up your queries, or let it write and validate schema changes against real data
  • Run ardent branch info to see the connection URL and status for your current branch
  • Create more branches for different tasks — they auto-suspend when idle, so don’t worry about cleanup
  • Working across multiple databases or environments? Use ardent project switch and ardent connector switch to move between them

CLI Reference

Every command, flag, and option.

FAQ

Common questions answered.