Stillcurrent — AI skill for Claude Code

Stillcurrent

Stillcurrent keeps the architecture docs and diagrams of your software up to date: LLM agents write and update them over MCP and a REST API, and engineers and architects read them. Documents are Markdown with first-class Mermaid diagrams. Users sign in, keep their documents in PostgreSQL, group them into projects, and read them with IBM Plex typography, a contents sidebar, callouts, highlighted code and themed, zoomable diagrams (with special routing for C4). Scripts use a REST API; LLM clients connect over MCP.

• Stack: Next.js 16 (App Router), React 19, TypeScript, PostgreSQL 17 with Drizzle ORM, Better Auth, Zod, marked + DOMPurify + highlight.js, Mermaid 11.16, CodeMirror 6, Vitest and Playwright.
• Contracts: docs/GUIDE.md is the authoring guide served at /guide (and raw at /guide.md); everything it promises renders. PLAN.md is the build plan; CLAUDE.md holds the coding rules.

Getting started

Requirements: Node 22 LTS, pnpm 10 (`corepack enable`), Docker.

pnpm install
cp .env.example .env.local          # then set BETTER_AUTH_SECRET (openssl rand -base64 32)
pnpm db:up                          # Postgres 17 in Docker, with the stillcurrent and stillcurrent_test databases
pnpm db:migrate
pnpm db:seed                        # dev@example.com / dev-password-123 and the welcome document
pnpm dev                            # http://localhost:3000

To run the whole stack in Docker instead (Postgres, migrations and the app on http://localhost:8080), put a `BETTER_AUTH_SECRET` in a `.env` file next to `docker-compose.yml` (there is no default, so no two installations share one), then:

docker compose up -d --build

The local Compose file has a development database password and open sign-up; never expose it. See [Deployment](#deployment) for production.

Scripts

Command	What it does
pnpm dev	Dev server (Turbopack)
pnpm build / pnpm start	Production build and server
`