GeneSYS Functionality Inventory
GeneSYS is a local-first coding workspace and control plane. It combines a CLI, terminal viewer, web workspace, control console, policy-aware tools, durable memory, plugin/MCP/LSP integration, sandboxed execution, and a HACP harness for Sigroom room participation.
Operator Surfaces
| Surface | Implemented Capability |
|---|---|
| gene CLI | Top-level commands for setup, runtime start/stop, auth, ask/plan/build/review/patch/submit, diagnostics, channels, companion, pairing, secrets, config, enterprise, memory, sessions, shell, long-running runs, tools, plugins, policy, mode, autonomy, logs, rooms, local identity, sandbox, browser, PTC, self-heal, reference, explore, research, and trading-help. |
| Terminal viewer | Session-centric TUI for transcript rendering, shell passthrough, slash menu, plugin manager, runtime health, session attach, scrollback, suggestions, and terminal paste handling. |
| apps/everything | Workspace web app with Home, Work, Inbox, Tasks, Schedule, Session, Project, Companion, Plugins, Media, Results, Profile, Settings, Listen, Watch, and Shop routes. |
| apps/playground | Control console with Overview, Workspace, Memory, Models, Prompts, Policy, Mode/Autonomy, Tools, Plugins, Channels, Pairing, Logs, Audit, Sandbox, SelfHeal, MediaStore, PTC, Nodes, Settings, and auth/onboarding routes. |
| packages/hacp-harness | Sigroom-facing HACP harness with bootstrap, launch contract, startup guard, runtime context, runtime coordinator, runtime turn handling, loop supervision, platform endpoints, signing client, output coordination, package boundary, and tool policy. |
| Full release bundle | Offline installer bundle that stages publishable GeneSYS tarballs, emits install scripts and release metadata, and installs a gene shim from bundled tarballs without lifecycle scripts. |
| plugins/media-store | Bundled media-store plugin with MCP server, security wrapper, integration tests, and a skill entry. |
CLI Command Groups
| Group | Commands |
|---|---|
| Core | init, setup, start, login, ask, doctor, whoami, logout, enroll, stop |
| Agentic work | plan, build, review, patch, submit, long-running, ptc, selfheal |
| Runtime state | config, secret, memory, sessions, shell, tools, policy, mode, autonomy, logs |
| Collaboration | rooms, join, leave, gateway, channels, companion, pairing |
| Plugins and references | plugins/plugin, reload-plugins, reference, explore, research |
| Sandbox and browser | sandbox, browser, browser act, managed process/browser tooling through built-in tools |
| Enterprise and security | enterprise, security, permissions, sandbox readiness, policy audit, release/package guardrails |
| Specialized analysis | trading-help for containerized TradingAgents market reports and JSON artifacts |
Runtime, Tools, And Policy
- Core runtime code manages sessions, prompt assembly, mode prompts, autonomy, compaction safety, workspace context, planning, tool fallback, tool filtering, provider routing, and persistent session state.
- Built-in tools include file read/write/list/stat/glob/grep/edit, apply_patch, bash/program execution, process lifecycle, jobs and rules, Git branch/commit/diff/push/PR/worktree operations, MCP resource access, plugin MCP/LSP calls, memory get/search/recall/profile, model listing, browser open/click/screenshot, webfetch/websearch, validation runs, task delegation/events, subagents, temporal setup/status/stop/namespace, tool permissions, todos, content extraction/decoding, code symbol/reference/diagnostic helpers, and user questions.
- Tool policy is represented through groups, skill-aware selection, permission checks, approval prompts, managed policy views, enterprise worker requirements, and audit events.
- Sandbox support spans provider-neutral sandbox types, Docker/gVisor readiness helpers, browser sandbox state, workspace/browser instance lifecycle, process tracing, and enterprise hardening checks.
Memory, Prompts, And Compaction
- Memory packages cover local-first memory providers, memory state, lifecycle, profile memory, MEMORY.md-style context, recall/search/profile tools, and memory method registration.
- The memory worker performs session extraction, consolidation, compaction summaries, HACP-facing memory handling, worker handlers, and dream consolidation jobs.
- Prompt infrastructure includes bootstrap/runtime/system/inbound/report slots, prompt registry and store, skill routing, context budget accounting, and session-mode prompt augmentation.
- Compaction and resume flows preserve summaries, memory references, memory index paths, candidate/write counts, and durable metadata on sessions.
Plugins, MCP, LSP, And Channels
- Plugin runtime supports Claude-compatible plugin manifests, marketplace install/import, enable/disable/uninstall, component resolution, skill discovery, agents, hooks, MCP servers, LSP servers, sandboxed plugin server supervision, status reporting, preflight smoke tests, and dynamic MCP tool naming.
- Runtime registrars expose auth, control, media, notifications, pairing, plugins, projects, PTC, sandbox, schedule, self-heal, sessions, tasks, and verification methods.
- Channel adapters include Telegram plus service hooks for Slack, Discord, Signal, Line, Lark, BlueBubbles, Baileys, and related pairing/delivery status surfaces.
- Companion functionality includes conversation/task sessions, companion jobs, rules, schedule storage, Temporal-backed workflows, and hidden control sessions.
Web Apps
- The Everything workspace is optimized for active work: ask/research/task/follow-up entry points, active sessions, recent activity, task lanes, schedule lanes, companion health, plugin marketplaces, media plugin checks, project sessions, transcript detail, profile summary, runtime configuration, and unavailable/not-found handling.
- The Playground control console is optimized for operators: runtime health, control signals, memory ledger, model/provider lanes, prompt groups, policy/mode/autonomy state, tools and bootstrap profiles, plugin runtime counts, channel adapters, pairing approvals, logs, audit tail/archive views, sandbox state, self-heal jobs, media-store status, PTC runs, and settings.
- Shared UI models in packages/ui define runtime health, audit timelines, enterprise policy/docker/install/worker health, workspace connection/run/task states, prompt context breakdowns, transcript entries, tool activity, approvals, pending questions, checkpoints, skills, memory, diffs, and command catalog metadata.
Sigroom And HACP Integration
- The @hacp/genesys-harness package is the bridge from local GeneSYS execution into Sigroom rooms.
- Launch contracts and startup guards enforce package boundaries before a harness joins a room.
- Runtime coordinators, runtime turns, output buffers, and loop supervision translate GeneSYS work into HACP-compatible room activity.
- HACP Control exposes hacp work commands that preview or call Sigroom harness-task API routes for list, select, edit, complete, test, test-all, sandbox-open, sandbox-status, and sandbox-stop.
- Launcher signing and platform endpoint modules connect local runtime evidence, Sigroom platform APIs, and signed receipts.
- @gene/loop-engine supports autonomous loop workitems that Sigroom can schedule and observe.
Operations, Release, And Verification
- Repository scripts cover package builds, app builds, CLI web asset bundling, HACP harness packaging, full release packaging, local install from packed packages, post-publish verification, dependency-policy checks, SBOM generation, audit/signature checks, sandbox security checks, release guardrails, clean dist, and version bumping.
- Production package builds now minify tsup output across GeneSYS packages, and Vite web app builds use esbuild minification with sourcemaps disabled.
- Full GeneSYS release packaging rejects source maps, sourceMappingURL references, TypeScript source files, node_modules paths, and hidden worktree/cache directories before publishing a bundle.
- Live acceptance lanes include workspace E2E tests and HACP verification modes when provider credentials or local live services are available.
- Trading help runs a vendored TradingAgents engine in Docker with allowlisted provider secrets, persistent report/checkpoint directories, JSON output, and an explicit financial-advice disclaimer.
- Current GeneSYS apps/docs is a placeholder package; this Sigroom page and the GeneSYS apps/docs README are the current functionality inventories until a hosted GeneSYS docs site is implemented.
Source Material
- /Users/pnayak/projects/GeneSYS/README.md
- /Users/pnayak/projects/GeneSYS/packages/ui/src/index.ts
- /Users/pnayak/projects/GeneSYS/packages/cli/src/commands
- /Users/pnayak/projects/GeneSYS/packages/tools/src/tools
- /Users/pnayak/projects/GeneSYS/apps/everything/src/pages
- /Users/pnayak/projects/GeneSYS/apps/playground/src/pages
- /Users/pnayak/projects/GeneSYS/packages/hacp-harness/src
- /Users/pnayak/projects/GeneSYS/scripts/package-full-genesys-release.mjs
- /Users/pnayak/projects/GeneSYS/docs/runbooks/RUNBOOK_RELEASE_DOWNLOADS.md