| FazBrowse GitHub Viewer | Trending | | Home |
| Tools: [Download Repo ZIP] [Original HTTPS Page] |
| Name | Name | Last commit date | ||
|---|---|---|---|---|
Mogplex is the open-source platform for agent-native software development.
Coding agents plan, build, test, review, and ship inside isolated sandboxes you can watch, on a platform you can read, run, and change. Point it at a GitHub repository and carry work from a trigger (a chat message, a Slack thread, a webhook, a schedule) to a merged pull request, with your gates deciding what ships.
If you have used a hosted agent-development platform and wished you could inspect the harness, swap the model, run it on your own infrastructure, or fix the thing that annoyed you, Mogplex is that platform with the source open.
Status: pre-1.0. Mogplex is used in production at mogplex.com, but the product and schema are still moving quickly. Expect rough edges and fast iteration.
flowchart LR
User[Browser / CLI / Slack / MCP] --> Next[Next.js app]
Next --> DB[Neon Postgres + Better Auth]
Next --> GitHub[GitHub OAuth + GitHub App]
Next --> Sandbox[Vercel Sandbox]
Next --> Gateway[Vercel AI Gateway / provider keys]
Next --> Trigger[Trigger.dev background jobs]
Trigger --> Sandbox
Trigger --> DB
| Piece | Role |
|---|---|
| Next.js (App Router) | UI, API routes, MCP server, webhooks |
| Neon Postgres | All application state; migrations in neon/migrations/ |
| Better Auth | Sign-in (GitHub, Google, email) and sessions |
| GitHub App | Repo access, webhooks, checks |
| Vercel Sandbox | Isolated compute for every agent session |
| Vercel AI Gateway | Model routing, with OpenRouter and direct keys as alternatives |
| Trigger.dev | Long-running agent runs, automations, syncs |
pnpm installcp .env.example .env.localThe minimum set for a working local app:
| Variable | Purpose |
|---|---|
| MOGPLEX_DATA_BACKEND=neon and NEXT_PUBLIC_MOGPLEX_DATA_BACKEND=neon | Select the Postgres + Better Auth backend. Both must agree; the public one is inlined at build time. |
| DATABASE_URL, DATABASE_URL_UNPOOLED | Pooled and direct Postgres connections |
| BETTER_AUTH_SECRET | Session signing secret |
| AUTH_GITHUB_CLIENT_ID, AUTH_GITHUB_CLIENT_SECRET | GitHub sign-in (or use Google / email) |
| NEXT_PUBLIC_APP_URL | Canonical app URL, http://localhost:3000 locally |
| CRON_SECRET, INTERNAL_API_SECRET, CONNECTIONS_ENCRYPTION_KEY | Machine auth and credential encryption; generate random values |
Every optional integration is documented inline in .env.example.
pnpm exec tsx --env-file=.env.local scripts/apply-neon-migrations.tsOn an empty database this first applies neon/baseline.sql, a schema snapshot generated from a fully migrated database, and records every migration it covers as applied. Then, and on every later run, it applies pending neon/migrations/*.sql in order against DATABASE_URL and records what ran. Add --dry-run to preview. The --env-file flag is what lets the script see .env.local; in CI and production the variable is exported instead.
pnpm devOpen http://localhost:3000 and sign in.
| Want to | Configure |
|---|---|
| Import repos and receive webhooks | GitHub App envs |
| Launch agent sandboxes | PLATFORM_VERCEL_TOKEN, PLATFORM_VERCEL_TEAM_ID, VERCEL_PROJECT_ID |
| Run models | AI_GATEWAY_API_KEY or provider keys, or let users bring their own in Settings |
| Run long jobs and automations | Trigger.dev envs, then pnpm trigger:dev |
| Slack, Stripe, Sentry, Resend | See the matching sections in .env.example |
pnpm dev # Next.js dev server
pnpm build # production build
pnpm lint # ESLint + Stylelint
pnpm typecheck # tsc
pnpm test:unit # unit tests
pnpm test:db # database-backed tests
pnpm test:e2e # Playwright
pnpm harness:check
pnpm trigger:dev # local Trigger.dev worker
pnpm git:cleanup # return to main and prune merged branchesRun one unit test file with pnpm exec tsx --test tests/unit/some-file.test.ts and one Playwright spec with pnpm exec playwright test tests/e2e/some-spec.spec.ts. First-time Playwright setup: pnpm exec playwright install --with-deps chromium. TESTING.md defines what coverage a change must bring.
Mogplex is built to be self-hosted. The same code that runs mogplex.com runs on your own Vercel team, Neon project, and Trigger.dev project, and the Apache-2.0 license has no fee, no seat limit, and no feature gating.
Start with docs/self-hosting.md. It lists every backing service, what each one unlocks, and the Dockerfile / docker-compose.yml path if you prefer containers over Vercel. If something in the self-hosting path is harder than it should be, open an issue or a discussion. Making that path smoother is a priority for the project.
Production deploys are schema-first.
Contributor requirements: migration rules and schema compatibility tests.
Relevant files: ci.yml, deploy-production.yml, vercel.json.
Related repositories: Mogplex/cli and Mogplex/docs (published at docs.mogplex.com).
Apache License 2.0. See NOTICE for attribution.
| Back | FazBrowse Home | New Git URL |