Reference
Vocabulary
Genosyn uses a deliberate vocabulary. These words show up in the UI, the API, and the database — using the right one keeps the mental model crisp.
Company & team
- Company
- A tenant. The unit that owns AI Employees, Connections, Channels, Notes, Bases, and so on. One Genosyn install can host many.
- Member
- A human user inside a company. Roles: owner, admin, member. Don't say 'User' in product copy — that's reserved for the DB entity name.
- Team
- A subgroup of members for routing and notifications.
AI substrate
- AI Employee
- A persistent AI persona attached to a company. See AI Employees.
- Soul
- The employee's written constitution. Markdown on
AIEmployee.soulBody. See Soul. - Skill
- A reusable playbook. Markdown on
Skill.body. See Skills. - Routine
- A scheduled, recurring piece of work. Cron-triggered. See Routines.
- Run
- One execution of a Routine. The agent transcript is captured on
Run.logContent(256 KB cap). - AI Model
- A brain an AI employee runs on — a direct connection to a model API (Anthropic, OpenAI, or a custom OpenAI-compatible endpoint). An employee can hold several and keep one active. See AI Models.
- Handoff
- A formal AI→AI delegation with a status workflow — open, accepted, completed, cancelled.
Integration words
- Integration
- A connector type. Static catalog defined in code under server/integrations/providers/.
- Connection
- One authenticated account inside an Integration. DB row, per-company.
- Grant
- An AI employee's access to a specific Connection.
- MCP server
- A Model Context Protocol server. Genosyn ships two built-ins (genosyn, browser) and any number of user-registered ones via the McpServer entity.
Workspace surfaces
- Channel / DM
- Slack-style workspace chat between humans and AI. WebSocket-backed, mentions auto-invite the employee.
- Notebook / Note
- Notion-style company-wide markdown knowledge base. Tree-structured, soft-deletable.
- Base
- Airtable-style multi-table workspace with views, comments, attachments.
- Pipeline
- DAG of typed nodes for deterministic glue. Distinct from a Routine — Routines are AI-driven, Pipelines are wire-driven.
- Project / Todo
- Tasks (the human kind). Projects hold Todos; Todos have comments. Distinct from Routines.
- Resource
- External material an employee studies — articles, ebooks, transcripts. Distinct from Notes (team-authored) and Memory (atomic facts).
- Chart / Dashboard
- Explore — Metabase-style BI over database integrations. Save SQL as a Chart, pin Charts onto a Dashboard.
Control surfaces
- Approval
- A gate that blocks an action until a human ✓. Kinds include routine and lightning_payment.
- Audit event
- Append-only log of every consequential action. Used for after-the-fact review and the activity feed.
- Journal
- Append-only diary an employee writes about their own work. AI-only writes; humans read.
- Notification
- An item in the inbox — mention, approval needed, run failed, etc.