TrapFall

Appearance

CLI Reference ​

trapfall serve ​

Start the HTTP server.

bash
trapfall serve [OPTIONS]

Options:
  --listen <ADDR>    Listen address (default: 0.0.0.0:3000)
  --db <PATH>        SQLite database path (default: trapfall.db)
  --port <PORT>      Listen port (default: 3000)

Environment variables TRAPFALL_LISTEN and TRAPFALL_DB override CLI flags.

trapfall migrate ​

Run database migrations. This is automatic on serve, but can be run explicitly.

bash
trapfall migrate --db trapfall.db

trapfall project add ​

Create a new project.

bash
trapfall project add "Project Name" [slug]

# Examples
trapfall project add "My Web App"              # slug: my-web-app
trapfall project add "Backend API" backend     # slug: backend

Outputs the project name, slug, and DSN.

trapfall project list ​

List all projects.

bash
trapfall project list

trapfall project rotate-dsn ​

Generate a new DSN key for a project. Old DSN stops working immediately.

bash
trapfall project rotate-dsn <slug>

trapfall healthcheck ​

Check if the server is running and healthy. Returns exit code 0 on success.

bash
trapfall healthcheck --db /data/trapfall.db

Used by Docker HEALTHCHECK.

trapfall mcp ​

Start the MCP server for AI agent tools. Communicates via stdio JSON-RPC 2.0.

bash
trapfall mcp --db trapfall.db

See MCP Server for available tools.