How codejunkie99/meridian-company-os works
Meridian OS is a local-first operating console for managing multi-company human/AI teams. Operators navigate the console to inspect company state, create and run work, govern consequential actions, and monitor goals, activity, and spending. A shared store holds the operating model, advances a simulation, and persists snapshots; agent execution can use the local Kimi runtime, while OAuth is an optional separate connection path. The README documents the broader views and integrations; unsampled view internals are represented by their exact paths, with only documented wiring shown.
Main entry points: App.tsx App shell · store.tsx Operating store · Space.tsx Kimi Space · Work.tsx Work board
Components 25
Operator console
- App shell
src/App.tsx - Command palette
src/components/CommandPalette.tsx
Company operations
- Kimi Space
src/views/Space.tsx - Work board
src/views/Work.tsx - Goals view
src/views/Goals.tsx - Org chart
src/views/Org.tsx - Agent roster
src/views/Agents.tsx - Skills view
src/views/Skills.tsx
Governance and insight
- Approvals inbox
src/views/Approvals.tsx - Finance view
src/views/Finance.tsx - Activity log
src/views/Activity.tsx - CEO reports
src/views/Reports.tsx - Company portfolio
src/views/Portfolio.tsx
State and execution
- Operating store
src/lib/store.tsx - Agent runner
src/lib/runtime.ts - Seeded companies
src/lib/seed.ts - Skill registry
src/lib/skills.ts - Snapshot API
server/stateApi.ts - Local KV store
server/db.ts
Kimi integrations
- Kimi bridge
server/kimiBridge.ts - OAuth card
src/components/KimiConnect.tsx - OAuth client
src/lib/kimiAuth.ts
Other components
- Operator
- Kimi CLI
- Kimi auth service
Connections 32
- Operator → App shell: uses
- App shell → Operating store: reads state
- App shell → Command palette: opens
- App shell → Kimi Space: renders
- App shell → Work board: renders
- App shell → Goals view: renders
- App shell → Org chart: renders
- App shell → Agent roster: renders
- App shell → Skills view: renders
- App shell → Approvals inbox: renders
- App shell → Finance view: renders
- App shell → Activity log: renders
- App shell → CEO reports: renders
- App shell → Company portfolio: renders
- Command palette → Operating store: dispatches actions
- Work board → Operating store: reads and dispatches
- Kimi Space → Operating store: reads and dispatches
- Agent roster → Operating store: reads and dispatches
- Skills view → Operating store: reads and dispatches
- Approvals inbox → Operating store: reads and dispatches
- Operating store → Seeded companies: initializes from
- Operating store → Agent runner: runs autopilot
- Work board → Agent runner: runs agent
- Kimi Space → Agent runner: runs agent
- Operating store → Snapshot API: loads and saves snapshots
- Snapshot API → Local KV store: reads and writes
- OAuth card → OAuth client: starts and polls
- OAuth client → Kimi auth service: requests OAuth
- Kimi Space → Kimi bridge: sends local chat
- Kimi bridge → Kimi CLI: spawns
- Kimi bridge → Local KV store: stores sessions
- Skill registry → Work board: provides skills