context setup

The setup command is the fastest way to get started with ContextKit. It runs an interactive wizard that chains together the core workflow commands automatically.

Usage

context setup

No options required. The wizard will prompt you for everything it needs.

What it does

The setup wizard walks through six stages:

1. Detect — Scans your environment for databases: environment variables, .env files, MCP server configs (Claude Code, Cursor, VS Code, Windsurf, Claude Desktop), and database files in the current directory. If the required database driver is not installed, the wizard offers to install it automatically (smart driver detection).
2. Select tables — For large databases, lets you interactively pick which tables to include rather than introspecting everything.
3. Introspect — Connects to the detected database and scaffolds Bronze-level context files for the selected tables.
4. Scaffold — Writes .context.yaml files into your project’s context/ directory.
5. Enrich — Offers to apply Silver-level enrichments using AI-generated descriptions and relationships.
6. Capture intent — Asks about your goals and priorities so AI agents can focus curation efforts. Generates context/AGENT_INSTRUCTIONS.md — a comprehensive guide that tells any AI agent (Claude Code, Cursor, Windsurf, etc.) exactly how to curate metadata toward Gold tier.

Example session

$ context setup
Detecting databases...
  Found: DATABASE_URL=postgres://localhost:5432/myapp

Connect to postgres://localhost:5432/myapp? (Y/n) Y

Select tables to include:
  [x] users
  [x] orders
  [x] products
  [ ] _migrations
  ...
  Selected 23 of 27 tables

Introspecting schema...
  Found 23 tables, 4 views
  Scaffolded 27 context files to ./context/

Enrich to Silver tier? (Y/n) Y
  Enriching users...
  Enriching orders...
  ...
  Done. 27 files enriched.

What are your goals for this data? (optional)
> We need agents to generate correct revenue reports

Generated context/AGENT_INSTRUCTIONS.md

Run 'context lint' to check for issues.
Run 'context serve' to start the MCP server.

When to use setup vs. individual commands

Scenario	Recommendation
First time with ContextKit	context setup
Adding a new database source	context introspect --db <url>
Upgrading existing context to Gold	context enrich --target gold
CI/CD pipeline	context lint && context build

Next steps

• Review the generated files with context lint
• Start serving context with context serve