How happier-dev/happier works
Happier is a multi-device control room for running coding agents on users’ machines. The main workflow is to choose a machine, project folder, and agent, start or attach to a session, then follow the transcript and steer or approve work from another device. Sessions can also delegate runs to other agents, switch engines, and support reviews. The graph includes the documented client/server/daemon roles and distinct agent, permission, replication, and connected-service capabilities. Source excerpts are partial, so some documented links are shown with README evidence rather than inferred source calls.
Main entry points: initializeBackendRunSession.ts Agent runtime · useTranscriptItemsPipeline.tsx Happier app · switchPipeline.ts Connected-service groups · happier.mjs CLI entry
Components 19
User clients
- Happier app
apps/ui/sources/components/sessions/transcript/items/useTranscriptItemsPipeline.tsx - CLI entry
apps/cli/bin/happier.mjs - Service auth controls
apps/ui/sources/components/sessions/agentInput/hooks/useSessionConnectedServicesAuthSwitch.tsx - Group query
apps/ui/sources/hooks/server/connectedServices/useConnectedServiceAuthGroupsQuery.ts - New-session setup
apps/ui/sources/components/sessions/new/hooks/screenModel/useNewSessionTranscriptStorageState.ts
Session coordination
- Happier server
apps/server/sources/app/api/socket/sessionUpdateHandler.ts - Session writes
apps/server/sources/app/session/sessionWriteService.ts - Usage sources
apps/server/sources/app/api/routes/connect/providerAccountUsage/sourceStorage.ts
Agent execution
- Agent runtime
apps/cli/src/agent/runtime/initializeBackendRunSession.ts - ACP agents
apps/cli/src/agent/acp/createAcpBackend.ts - Subagent runs
apps/cli/src/agent/executionRuns/runtime/ExecutionRunManager.ts
Machine services
- Machine daemon
packages/cli-common/src/relayHost/relayHostEngine.ts
Session capabilities
- Approvals
apps/cli/src/agent/permissions/permissionRequestCoordinator.ts - Code reviews
apps/cli/src/agent/reviews/engines/nativeReviewEngines.ts - Workspace replication
apps/cli/src/workspaces/replication/createWorkspaceReplicationEngine.ts - Replication jobs
apps/cli/src/workspaces/replication/jobs/workspaceReplicationJobStore.ts - Connected-service groups
apps/cli/src/daemon/connectedServices/accountGroups/switching/pipeline/switchPipeline.ts - Transcript storage policy
packages/protocol/src/encryption/storagePolicyDecisions.ts
Other components
- User
Connections 19
- User → Happier app: starts session
README.md - User → CLI entry: starts session
README.md - Happier app → New-session setup: configures
apps/ui/sources/components/sessions/new/hooks/screenModel/useNewSessionTranscriptStorageState.ts - New-session setup → Transcript storage policy: resolves storage
- Happier app → Happier server: follows session
README.md - CLI entry → Machine daemon: runs on machine
README.md - Machine daemon → Agent runtime: launches agent
- Agent runtime → ACP agents: supports ACP
- Agent runtime → Subagent runs: coordinates runs
- Agent runtime → Approvals: requests approval
- Agent runtime → Session writes: publishes updates
- Happier server → Session writes: routes updates
- Happier app → Approvals: steers and approves
README.md - Subagent runs → Code reviews: runs review
- User → Workspace replication: replicates workspace
- Workspace replication → Replication jobs: stores job state
apps/cli/src/workspaces/replication/createWorkspaceReplicationEngine.ts - Service auth controls → Connected-service groups: switches auth
- Group query → Connected-service groups: loads groups
- Connected-service groups → Usage sources: binds usage