Skip to content
This repository was archived by the owner on Mar 10, 2026. It is now read-only.

development.md

Latest commit

 

History

History
73 lines (50 loc) · 1.25 KB

development.md

File metadata and controls

73 lines (50 loc) · 1.25 KB

Development

Prerequisites

  • Go 1.24+
  • Docker + Docker Compose (optional)
  • MatrixOne/MySQL-compatible database (optional, only if using SQL persistence)

Environment

cp .env.example .env

Important env vars:

  • DAY1_PORT (default 9821)
  • DAY1_DATABASE_URL (empty = in-memory backend)
  • DAY1_EMBEDDING_PROVIDER / DAY1_LLM_PROVIDER and related BYOK keys
  • Optional auth: DAY1_AUTH_ENABLED, DAY1_AUTH_ADMIN_KEY, DAY1_BOOTSTRAP_ADMIN_USER_ID (requires DAY1_DATABASE_URL)

Run API and CLI

# API server
go run ./cmd/day1-api

# CLI
go run ./cmd/day1 help
go run ./cmd/day1 health

SQL persistence check

# No-op when DAY1_DATABASE_URL is not set
bash scripts/check_db.sh

# Explicit schema bootstrap
go run ./cmd/day1 migrate

Test and build

go test ./...
go build ./...

Docker Compose

# Dev profile (Go API)
docker compose --profile dev up -d

# Optional local MatrixOne from compose
docker compose --profile dev --profile matrixone up -d

# Validate config
docker compose config

MCP endpoint

When API is running, MCP endpoint is:

  • http://localhost:9821/mcp

Configure Claude Code:

claude mcp add --scope project --transport http day1 http://localhost:9821/mcp