How code-with-antonio/nightcode works
NightCode is a terminal-based AI coding agent. A user chooses or creates a session, chats in plan or build mode, and receives streamed model output; build mode can use local project tools. The CLI communicates with an authenticated Hono API, which gates new work on Polar credits, streams AI responses, and persists sessions and messages in Postgres. The graph also includes documented OAuth, model selection, and billing capabilities. Some links reflect README or SOURCE INDEX evidence rather than inspected implementation; unsampled modules are represented only at paths supported by the tree.
Main entry points: chat.ts Chat streaming route · api-client.ts API client · session.tsx Session screen · sessions.ts Session routes
Components 25
Terminal CLI
- CLI entry and screens
packages/cli/src/index.tsx - Session screen
packages/cli/src/screens/session.tsx - Session shell and input
packages/cli/src/components/session-shell.tsx - Chat messages
packages/cli/src/components/messages/bot-message.tsx - Chat client
packages/cli/src/hooks/use-chat.ts - Local project tools
packages/cli/src/lib/local-tools.ts - CLI OAuth flow
packages/cli/src/lib/oauth.ts - API client
packages/cli/src/lib/api-client.ts - Model and session dialogs
packages/cli/src/components/dialogs
API and workflow
- OAuth routes
packages/server/src/routes/auth.ts - Session routes
packages/server/src/routes/sessions.ts - Chat streaming route
packages/server/src/routes/chat.ts - Authentication middleware
packages/server/src/middleware/require-auth.ts - Credit balance gate
packages/server/src/middleware/require-credits-balance.ts - Billing routes
packages/server/src/routes/billing.ts
Shared AI domain
- Model registry
packages/server/src/lib/models.ts - System prompt
packages/server/src/system-prompt.ts - Usage metering
packages/server/src/lib/credits.ts - Shared schemas and models
packages/shared/src/schemas.ts
Persistence
- Prisma client
packages/database/src/client.ts - Postgres
External services
- Clerk OAuth
- Polar credits
- AI model providers
Other components
- User
Connections 30
- User → CLI entry and screens: uses
README.md - CLI entry and screens → Session screen: routes to
- Session screen → Session shell and input: renders
packages/cli/src/screens/session.tsx - Session screen → Chat client: submits chat
packages/cli/src/screens/session.tsx - Session screen → API client: loads session
packages/cli/src/screens/session.tsx - Session shell and input → Chat messages: displays
packages/cli/src/components/session-shell.tsx - Chat client → API client: sends chat
packages/cli/src/hooks/use-chat.ts - Chat client → Local project tools: executes tools
packages/cli/src/hooks/use-chat.ts - API client → OAuth routes: calls API
- API client → Session routes: calls API
- API client → Chat streaming route: calls API
- CLI OAuth flow → OAuth routes: completes OAuth
README.md - OAuth routes → Clerk OAuth: authenticates
README.md - Session routes → Prisma client: reads and writes
packages/server/src/routes/sessions.ts - Chat streaming route → Prisma client: persists history
packages/server/src/routes/chat.ts - Prisma client → Postgres: stores data
README.md - Session routes → Credit balance gate: checks credits
packages/server/src/routes/sessions.ts - Chat streaming route → Credit balance gate: checks credits
packages/server/src/routes/chat.ts - Session routes → Authentication middleware: requires auth
packages/server/src/routes/sessions.ts - Chat streaming route → Authentication middleware: requires auth
packages/server/src/routes/chat.ts - Authentication middleware → Clerk OAuth: verifies token
packages/server/src/middleware/require-auth.ts - Credit balance gate → Polar credits: checks balance
packages/server/src/middleware/require-credits-balance.ts - Chat streaming route → Model registry: selects model
packages/server/src/routes/chat.ts - Chat streaming route → System prompt: builds context
packages/server/src/routes/chat.ts - Chat streaming route → AI model providers: streams response
README.md - Chat streaming route → Usage metering: meters usage
packages/server/src/routes/chat.ts - Usage metering → Polar credits: ingests usage
README.md - Billing routes → Polar credits: creates checkout
README.md - Model and session dialogs → API client: loads sessions
packages/cli/src/components/dialogs/sessions-dialog.tsx - Model and session dialogs → Model registry: chooses model
README.md