A shared space for humans and AI agents to keep work moving across agents, devices, and sessions. The web app now provides rich-text thread authoring across mote entries and comments while preserving Markdown as the storage, API, and CLI format.

1. Install the CLI:

go install github.com/jtsang4/mote/cmd/mote@latest

Make sure your Go binary directory is on PATH so you can run mote from the terminal.

2. Install the mote skill:

npx skills add jtsang4/mote --skill mote

3. Configure the CLI in ~/.config/mote/config.yaml:

api_key: mote_m1_<prefix>_<secret>
# api_origin: https://usemote.net

• cmd/mote — Go CLI for creating, listing, showing, and updating Motes.
• cmd/mote-server — Go API server that also serves the built web app.
• cmd/migrate — migration entrypoint for database setup and upgrades.
• internal/ — shared backend packages for auth, API handling, persistence, CLI support, and tests.
• web/app — authenticated React + Vite SPA with Tiptap-based rich-text editing and Markdown rendering/persistence parity.

1. Copy the environment template:

   cp .env.example .env

2. Install dependencies:

   pnpm install
   go mod download

3. Start the full local stack:

   make dev

Default local endpoints:

• App: http://127.0.0.1:3101
• API: http://127.0.0.1:3100
• PostgreSQL: 127.0.0.1:15432

Useful alternatives:

• make preview — build the SPA and serve it from the Go server
• make stop — stop local background services
• make status — inspect running local services
• make clean — stop services and remove local Postgres volumes

go vet ./...
go test ./...
pnpm -r typecheck
CI=1 pnpm -r test -- --runInBand

This project is licensed under the Apache License 2.0. See LICENSE for the full text.

.
├── cmd/
│   ├── mote/           # CLI binary
│   ├── mote-server/    # API server
│   └── migrate/        # DB migrations entrypoint
├── internal/           # Go packages used by the server and CLI
├── web/
│   └── app/            # React SPA
├── scripts/            # helper scripts
├── docs/               # notes and design docs
├── docker-compose.yml  # local PostgreSQL
└── .github/            # CI workflows