Mobicode documentation

Mobicode is a self-hosted, mobile-first coding-agent API. It ships as a single Go binary with a GraphQL API, SQLite persistence, and a single mobile-owned Nostr identity.

Getting Started

Clone the repository and configure the application:

git clone https://github.com/soumajitgh/mobicode.git
cd mobicode
cp .env.example .env

Set PUBLIC_BASE_URL to the API's canonical public origin, then initialize and start the API:

PUBLIC_BASE_URL=https://example.com

go run ./cmd/mobicode init --config .env
go run ./cmd/mobicode serve --config .env

Open /welcome once the server is running. MobiCode sends you to GitHub to create a private GitHub App in your account and choose its repositories. After GitHub returns you to setup, scan the QR code with the mobile app and approve the displayed public-key fingerprint. The paired mobile key signs all GraphQL requests with NIP-98. Health checks are available at /health.

Getting Started​

Getting Started