Skip to content
BranchesTags

Repository files navigation

GodMode

CI Release License

Your Control Center: create, edit, organize, and monitor everything you do for yourself, your agents, and your people. Built to be the last platform stack you need.

Open source (Apache 2.0). Local-first. Self-host or use Cloud for convenience. Self-expanding: Intelligence builds and extends GodMode from inside GodMode. Digital You is your twin (thinking partner and stand-in). Connect anything via Marketplace packs, plugins, and connectors. Share live resources with your team.

GodMode home hub

Quick demo: docs/assets/readme/demo.gif

Terminology

Name Meaning
Intelligence The built-in platform agent: your guide to GodMode itself
Chat panel The sidebar floating window where you talk to agents (not the agent's name)
Digital You Your digital twin: private thinking partner and stand-in; compounds via Reflection and memory as you use the platform
Agents → Pipeline Where you configure models, tools, rules, and profiles

Why GodMode?

GodMode is the last platform stack for everything you do digitally: one Control Center where you create, edit, organize, and monitor knowledge, work, people, money surfaces, and agents.

  • Self-expansion: Intelligence scaffolds, codes, and installs plugins and workspace structure from chat (GodMode-from-GodMode). You extend the product without leaving it.
  • Digital You: twin agent for personal judgment and voice; stand-in quality deepens as memories and Reflection accumulate. Distinct from Intelligence (platform builder/guide).
  • Connect anything: Marketplace Official/Community packs, Local plugins on self-host, Connector for hardware-bound plugins, coding tools for custom integrations. Niche professions stay packs; Core stays universal.
  • Open source + install flexibility: desktop, clone, private hub, or Cloud. Cloud is browser onboarding and commerce authority; local/desktop stay first-class.

Full accounting, owned email/domains, robot/IoT actor plane, and GodMode Inference by ReBotics are Core depth on the roadmap. See CORE_VS_PLUGINS.md and the feature catalog.

Roadmap

Usable now. Core still grows toward the full Control Center (owned email and domains, accounting depth, robot/IoT actors, owned inference and training, and more). Track it on the GodMode Roadmap.

Ready column doctrine: P0 is Hostinger SaaS live (easier browser onboarding + revenue; local/desktop stay first-class). P1 is dogfood GodMode-from-GodMode (plugins + Core), then marketplace trust. Core epic depth stays in Backlog until live and dogfood clear.

Features (overview)

Platform and agents

  • Home (/home) - dashboard and quick links
  • Intelligence - platform companion; setup, structure, cross-cutting work
  • Digital You - twin: thinking partner + stand-in; compounds with use
  • Chat panel - talk to any agent; history, tools, model picker
  • Agents (/agents) - org chart and Pipeline configuration

Knowledge (Chat → Knowledge tab)

Rules, Skills, Memory, Artifacts, Reflection, and Tools - per active agent.

Productivity

Structure, Wiki, Tasks (kanban + auto autonomous cards), Calendar, Notifications, Vault, Bank, and Support - in the sidebar and as Chat panel tabs.

Social and extension

Shared (live grants from other users), Marketplace (install and manage plugin packs), optional Connector for hardware-bound plugins.

Intelligence in Chat panel

Architecture

System overview

flowchart TB
  subgraph client [Your machine]
    Web[Web Dashboard React]
    Bridge[Bridge API Node.js]
    Kernel[ObjectType kernel]
    Services[Authoritative services and adapters]
    CoreDb[(core.sqlite users and tenants)]
    TenantDb[(tenant.sqlite per workspace)]
    Web -->|REST and WebSocket| Bridge
    Bridge --> Kernel
    Kernel --> Services
    Services --> CoreDb
    Services --> TenantDb
  end
  subgraph intelligence [Intelligence loop]
    User[You] --> Chat[Chat panel]
    Chat --> Tools[Platform tools]
    Tools --> Structure[Structure wiki tasks]
    Tools --> Memory[Memory and artifacts]
  end
  Web --> intelligence
Loading

Chat panel tabs vs sidebar pages

flowchart LR
  Sidebar[Sidebar pages] --> HomePage[Home]
  Sidebar --> WikiPage[Wiki]
  Sidebar --> TasksPage[Tasks]
  Chat[Chat panel tabs] --> ChatTab[Chat]
  Chat --> Know[Knowledge]
  Chat --> VaultTab[Vault]
  Chat --> BankTab[Bank]
  Chat --> SupportTab[Support]
  Chat --> AutoTab[Automations]
Loading

Agent organization

Intelligence is the platform root agent; department subagents report to it. Digital You is your digital twin (separate root in the database; parent_id is null), shown beside Intelligence in the org chart with no parent/child link between them.

flowchart TB
  subgraph roots [" "]
    direction LR
    Intel[Intelligence]
    DigitalYou[Digital You]
  end
  Intel --> DeptAgents[Department agents]
  DeptAgents --> PageAgents[Page-scoped agents]
  PageAgents --> Tools[Tools rules skills]
  Tools --> Platform[Wiki tasks calendar vault]
Loading

Plugin extension (optional)

flowchart LR
  Core[GodMode core]
  PluginHost[Plugin host]
  Plugin[Domain plugin repo]
  Core --> PluginHost
  PluginHost -->|discover at runtime| Plugin
  Plugin -->|registers ObjectTypes actions routes tools UI| Core
Loading

Core ships the Control Center. Plugins add domain packs without forking the platform. Plugin ObjectTypes are discoverable only for tenants where the plugin is installed. See docs/PLUGIN_AUTHORING.md.

Durable data goes through the ObjectType kernel: typed records, named actions, and adapters so mutations share one dispatch boundary. Async work uses leases, retries, timeouts, and recovery; live WebSocket streams and binary transfer stay specialized transports (not Record CRUD). Details for contributors: docs/OBJECTTYPE_KERNEL.md.

Quick start

Requirements: Node.js 22.13+, npm 10+

git clone https://github.com/ReBoticsAI/GodMode.git
cd GodMode
npm install
copy apps\bridge\.env.example apps\bridge\.env
npm run dev

Open http://localhost:5173, click Sign up, and create your account. The first signup becomes platform admin when INITIAL_ADMINS is empty.

Full walkthrough: docs/GETTING_STARTED.md · Env reference: docs/CONFIGURATION.md

Service URL
Web dashboard http://localhost:5173
Bridge API http://localhost:3847
WebSocket ws://localhost:3847/ws

Sign up

First steps after install

  1. Sign up with email and password (local auth only - no OAuth).
  2. Open Chat and select Intelligence. Add an LLM API key under Vault → Secrets, then configure the provider in Agents → Pipeline.
  3. Ask Intelligence to create your first department and pages, or use Structure once you have content.
  4. Optional: install plugins under Marketplace → Local (see docs/MARKETPLACE.md and docs/PLUGIN_AUTHORING.md).

Demo seed (screenshots / docs)

Populate a sample workspace for captures or local exploration:

npm run dev
# in another terminal:
$env:DEMO_PASSWORD = "your-demo-password"
node scripts/seed-readme-demo.mjs

Configuration

Copy apps/bridge/.env.example → apps/bridge/.env. Key variables:

Variable Purpose
AUTH_SESSION_SECRET Session signing secret - change before any network exposure
INITIAL_ADMIN_PASSWORD Optional password for pre-seeded INITIAL_ADMINS users
INITIAL_ADMINS Pre-seed admins as Name:email (leave empty for first-signup admin)
AUTH_ALLOW_SIGNUP Allow open signup (default true in local mode)
DEPLOYMENT_MODE local (default), hub, or client

LLM and integration keys belong in Vault inside the app, not in .env, unless you prefer env-based bootstrap.

Screenshots

OSS gallery

OSS empty home Contacts graph Chat modes Settings plugins
OSS home Contacts Chat modes Plugins
Marketplace Local Agents pipeline
Marketplace Agents

Platform

Home Structure Agents Wiki
Home Structure Agents Wiki

Chat panel

Intelligence Knowledge → Rules Memory Reflection
Intelligence Rules Memory Reflection
Vault Bank Support Automations
Vault Bank Support Automations
Notifications Calendar
Notifications Calendar

Productivity and social

Tasks Task detail Shared Marketplace
Tasks Task detail Shared (Tailscale network) Marketplace (Official catalog)
Support (GitHub + owner routing)
Support

Components

Component Path Role
Web dashboard apps/web React UI - Chat panel, structure, productivity
Desktop shell apps/desktop Electron installer that embeds Bridge + web for non-technical users
Bridge apps/bridge REST/WebSocket API, auth, multi-tenant SQLite
ObjectType kernel packages/kernel, apps/bridge/src/kernel Enforced durable dispatch, policies, Record CRUD/actions, async recovery, events, native storage, generated tools
Connector apps/connector Local runtime for hardware-bound marketplace plugins
Plugin API packages/plugin-api Plugin manifest and register contracts
Plugin host packages/plugin-host Runtime facades for plugins
Flow core packages/flow-core Shared structure and flow types

Deployment

Local mode (default) runs Bridge and Web on your workstation - ideal for personal use.

For the desktop download (Windows / macOS / Linux installers), Docker hub/client, and signed bare-metal deployments, see DEPLOY.md. Release channels and safe updates are documented in docs/RELEASES.md. Architecture details: docs/architecture.md.

Documentation

Full documentation index: docs/README.md
Get started GETTING_STARTED · ONBOARDING · FEATURES · LOCAL_LLM · CURSOR
Use GodMode AGENT_MEMORY · MARKETPLACE · SHARED_FEDERATION · CONFIGURATION · RELEASES · SECURITY
Deploy & extend DEPLOY · architecture · ObjectType kernel · PLUGIN_AUTHORING (contributors)
Project CHANGELOG · CONTRIBUTING · Issues

License

Apache License 2.0

Contributing

See CONTRIBUTING.md.

About

GodMode: Create, edit, organize, and monitor everything you do for yourself, your agents, and your people. Built to be the last platform stack you need.

Resources

Readme
Apache-2.0 license

Contributing

Contributing

Security policy

Security policy
Activity

Stars

1 star

Watchers

0 watching

Forks

0 forks
Report repository

Releases

Packages

Contributors

Languages