# Team-X (full reference) > Run an AI company. Not a prompt. > > Team-X is an open-source, MIT-licensed, local-first desktop application for running AI-agent organizations. The unit of work is a role, not a prompt. The substrate is an org, not a chat. The parent brand is Strategia-X (https://www.strategia-x.com). This file is the full product reference for Team-X: what the product is, what the current and previous releases changed, the privacy posture, a described index of every page and doc on the site, the editorial voice, and the source and parent links. The three llms files have one job each: llms.txt (https://team-x.app/llms.txt) is the short index, this file is the product reference, and long-llms.txt (https://team-x.app/long-llms.txt) is the complete blog and Field Notes archive. ## What Team-X is Team-X is an Electron-based desktop app that lets users: - Hire AI employees from a catalog of 55 hireable role specs across six hierarchy levels (Officer, Senior Management, Management, Supervisor, Lead, IC), plus two hidden system roles for the agentic loop and copilot service, for 57 specs in total. - Build a real org chart with editable reporting lines. - Set goals, decompose them into projects, and track tickets on a four-column kanban (Open / In Progress / Blocked / Done) with automatic agent assignment. - Hold one-click all-hands meetings with auto-generated minutes and action-item extraction. - Operate the entire team from a natural-language command palette (Cmd+K) covering 14 structured intents plus a `complex_request` fallback that hands off to the agentic loop. - Watch a five-subview live cockpit (Cards, Timeline, Stream, Floor, Commands) with live token streams, cost telemetry, and copilot insights. The app supports 9 LLM providers (Ollama, Anthropic, OpenAI, Google, Groq, OpenRouter, Together, Fireworks, plus any OpenAI-compatible endpoint) across three privacy tiers (Local, Open-Source Cloud, Proprietary Cloud), with a router that enforces the configured tier at call time. The launch version (v3.0) shipped with 2,150 passing tests on commit zero, cross-platform installers (Windows NSIS, macOS DMG, Linux AppImage / .deb), and a fully read-and-write SQLite + sqlite-vec stack with FTS5 search, append-only audit log, and SHA256-verified file vault. ## Current release: v3.5.0 (2026-10-08) - Privacy tiers are enforced, not just displayed. Every model call, embedding, and external runtime is checked against Settings > Privacy at the moment it runs. Codex, Claude Code, Cursor, and command runtimes count as Proprietary Cloud; an HTTP runtime counts as Local only on your own network. A provider above the tier is refused with a reason and is never silently swapped for another. - Copilot answers from the company's own knowledge: messages, tickets, meeting minutes, and vault files. Long-term memory and the knowledge graph survive restarts. - The Models tab runs GGUF models through a bundled llama.cpp, browses and downloads from Hugging Face with pause and resume, connects LM Studio, Ollama, or vLLM servers on the local network, and benchmarks real throughput. A GGUF model is not yet an agent provider; Ollama remains the local path for agents. - The command palette classifies input with a model, meetings write minutes and file their action items as tickets, the Hire dialog offers all 55 roles, Proactive Mode works per company, and a failed turn says why. - Electron 44 replaces Electron 31. The window runs only Team-X's own code, cannot be navigated away, and answers requests only from itself. - A fresh install opens on its first launch. An installed build looked for its starter roles in the wrong folder, so the first launch stopped with "Team-X failed to start"; that is fixed. - The Linux AppImage embeds a static runtime and needs no FUSE 2 library. - Each Windows and macOS installer is installed, launched, and uninstalled automatically before a release publishes. v3.5.0 is not code-signed, so Windows and macOS warn before the first run; every installer has a build-provenance attestation, and an SBOM is attached to the release. - Removed: the team-x-ai command-line tool, and the Streaming, Multi-Turn Planning, Max Tokens, and Temperature settings, which nothing applied. - The test suite stands at 4,682 passing tests across 372 files, with 20 Playwright E2E specs. The toolchain baseline is Node 22+ and pnpm 9+. ## Previous release: v3.4.0 (2026-07-11) - Every surface in the app now composes from one Command Console design system: machined faceplates, recessed phosphor LCD wells, stencil word-lamps, data-bound VU meters, armed-red command accents. Dual-shift theming ships throughout: Night Ops (brushed black, default) and Day Shift (silver anodized); displays stay void-black in both shifts. - Proactive Mode moved onto Mission Control as a dashboard control: a master enable toggle, an autonomy-mode readout, tiles for active work, queued work, and last scan, and a scan-for-work-now action. Correction, recorded in the v3.5.0 changelog: in v3.4.0 those three tiles were fed hardcoded zeros and reported no real activity, the per-company switch turned every company off, and proactive dispatch skipped the budget-admission check. v3.5.0 fixed all three (tiles and budget check: https://github.com/git-rocky-stack/team-x/blob/v3.5.0/CHANGELOG.md#L547-L558; per-company switch: https://github.com/git-rocky-stack/team-x/blob/v3.5.0/CHANGELOG.md#L424-L426). - The autonomy control plane covers ten modules: doctor, benchmarks, self-improvement, runtimes, routines, budgets, approvals, artifacts, memory, and operator access. Telemetry tracks runs, tokens, cost, and latency across company, employee, and cost scopes; the audit log is append-only; the vault verifies files by SHA256. - Accessibility hardening: WCAG AA contrast held in both shifts, dialogs close on Escape and carry screen-reader descriptions, dashboard subtabs announce via aria-current. - The test suite stood at 3,521 passing tests across 296 files, with 19 Playwright E2E specs. - Six installers publish per release (Windows Setup x64/arm64, macOS DMG x64/arm64, Linux AppImage x86_64 and .deb amd64) alongside a consolidated SHA256SUMS.txt and electron-updater manifests; in-app update checks remain strictly user-triggered. - The site's /product page carries real, unretouched frames of the shipped build: Mission Control, the autonomy control plane, telemetry, the Proactive Mode control, and a Night Ops / Day Shift pair of the same view. ## Privacy posture - Local-first: the recommended setup runs `llama3.1:8b` on Ollama with no cloud provider. - Zero phone-home: no analytics, no telemetry, no auto-update phone-home. Update checks are user-triggered against GitHub Releases. - OS keychain for secrets: API keys are stored in the macOS Keychain, Windows Credential Manager, or Linux Secret Service, never in plaintext config files. - Three privacy tiers govern which providers each agent run is allowed to use; the router enforces the cap. - The marketing site itself follows the same posture: no analytics, no third-party fonts (self-hosted woff2), no third-party scripts. ## Site index ### Marketing - https://team-x.app/ - Landing page with cockpit-fragment hero and the six ยง-sections (THE ORG, THE COCKPIT, INTELLIGENCE LAYER, PRIVACY POSTURE, INSTALL, FIELD NOTES). - https://team-x.app/product/ - Deep-dive on the cockpit, agentic loop, copilot, command palette, autonomy control plane with Proactive Mode, ops instruments, and dual-shift theming, with real screenshots of the shipped v3.4.0 build. - https://team-x.app/roles/ - Filterable catalog of the 55 hireable role specs (57 total including two system roles), served from the canonical role-pack at build time. - https://team-x.app/privacy/ - Local-first, zero phone-home, OS keychain, three privacy tiers explained in detail. - https://team-x.app/download/ - Direct v3.5.0 installers for six targets, the SHA256SUMS manifest, how to verify a download, Ollama setup snippet, build-from-source instructions. - https://team-x.app/about/ - Rocky Elsalaymeh's stake, the open-source thesis, Strategia-X attribution. - https://team-x.app/terms/ - Terms of Service. Free MIT software, no account, your AI providers and their costs are your responsibility, plain-language liability terms. - https://team-x.app/privacy-policy/ - Privacy Policy. The app collects and transmits nothing; the only personal data anywhere is the opt-in newsletter email, stored in Cloudflare D1, no tracking, no selling. ### Documentation The docs surface is comprehensive and searchable client-side via Pagefind. No queries leave the user's machine. There are seven sections: Getting started, Using Team-X, Advanced, Scenarios, Templates, Developer, and Reference. #### Getting started - https://team-x.app/docs/getting-started/ - Install, first boot, Ollama setup, first conversation, interface tour, the five Dashboard subviews. Fifteen-minute on-ramp. - https://team-x.app/docs/quick-start/ - The shortest path: install, configure one provider, hire your first employee, file your first ticket. The minimum viable Team-X session. - https://team-x.app/docs/hiring-employees/ - The 55 hireable roles, hiring from the pack, custom employees, org chart management, reporting-line rules. #### Using Team-X - https://team-x.app/docs/configuring-providers/ - Adding providers, setting privacy tiers (enforced at call time; a provider above the tier is refused, never swapped), the Models tab for native GGUF models, choosing a runtime strategy (Auto, Hybrid, Always-On, Lean), per-provider concurrency caps. OS keychain for API keys. - https://team-x.app/docs/command-palette/ - Cmd+K natural-language control surface. Fourteen structured intents (hire, fire, promote, assign, create_ticket, close_ticket, reopen_ticket, create_project, create_goal, call_meeting, end_meeting, check_status, show_view, search_vault) plus `complex_request` as a fallback to the agentic loop. Destructive-action confirmation gate enforced in main-process code. History recall via ArrowUp. Slash commands for direct navigation. - https://team-x.app/docs/agentic-loop/ - ReAct-style planning loop with six read-only org query tools (`query_employees`, `query_tickets`, `query_projects`, `query_meetings`, `query_vault`, `query_events`). Hard step / token / wall-clock budgets (defaults 8 steps, 8000 tokens, 120 seconds). Persisted threads on a hidden system-agent pseudo-employee, surfaced under the "Copilot Conversations" section of the chat sidebar. Six palette states (idle, streaming, complete, canceled, error, stopped). Cancellable via AbortController. - https://team-x.app/docs/copilot-service/ - The periodic analyzer that runs on a five-minute cadence and surfaces operational, cost, org, workflow, and anomaly insights. Includes the ask-the-copilot direct query path, feedback weights, repeated-dismissal suggestion audit trail, and Copilot run-kind tagging. - https://team-x.app/docs/copilot-ui/ - The sidebar panel, the dashboard widget, the Cmd+Shift+K shortcut, category and severity filters, feedback flow, and local CSV / JSON insight export. - https://team-x.app/docs/task-planner/ - Project decomposition into tickets, deterministic workload scoring for delegation, deliverable review, amber confirmation gate on write-side actions. Capability-backed role fit with the M32 keyword fallback preserved. - https://team-x.app/docs/managing-projects/ - Goals, projects, tickets, due dates, and the four-column kanban board. - https://team-x.app/docs/scheduling-and-calendar/ - Calendar view, ticket due dates, project targets, goal targets, reminders, future agent wakeups. - https://team-x.app/docs/using-the-vault/ - File storage, FTS5 search, SHA256 integrity verification, ticket attachments, agent-created deliverables. - https://team-x.app/docs/demo-walkthrough/ - Step-by-step walkthrough of the canonical Team-X demo: hire a CEO, create a ticket, hold an all-hands, ask the copilot. #### Advanced - https://team-x.app/docs/complete-user-guide/ - The full Team-X manual in a single page. Twenty sections covering every surface from first launch through workspaces, employees, mission control, command palette, tickets, projects, chat, meetings, files, copilot, autonomy, extensions, settings, telemetry, audit, troubleshooting, best practices, and keyboard shortcuts. The canonical read-it-all reference. - https://team-x.app/docs/autonomy-control-plane/ - Doctor, benchmarks, agent self-improvement, runtimes, routines, budgets, approvals, artifacts, agent-created files, memory, and operator access. The control surface for unattended runtime work. - https://team-x.app/docs/backup-and-restore/ - Single-archive backup containing the SQLite database and the file vault, with a manifest validated on restore. - https://team-x.app/docs/migration-guide/ - Moving workspaces between machines, migrating from prior versions, and handling breaking changes without losing org state, vault files, or audit history. #### Scenarios Seven real-world playbooks with step-by-step walkthroughs. - https://team-x.app/docs/scenario-product-development-lifecycle/ - End-to-end: spin up a product team, file the roadmap, build the MVP, ship the first release. - https://team-x.app/docs/scenario-cost-optimization-playbook/ - Provider tier selection, per-ticket budget caps, routine scheduling, copilot cost-anomaly signals. - https://team-x.app/docs/scenario-failure-recovery-workflows/ - Triage and recovery when agents fail, runtimes stall, or tickets block. The reference for Autonomy > Improve in production. - https://team-x.app/docs/scenario-cross-functional-collaboration/ - Multiple employees on one ticket, thread discussion, meeting handoffs, participant-wake semantics. - https://team-x.app/docs/scenario-autonomous-routine-governance/ - Standing up recurring unattended work safely: templates, approval gates, budget caps, audit trail. - https://team-x.app/docs/scenario-multi-workspace-operations/ - Multiple AI companies side by side: switching, per-workspace budgets, cross-org employee allocation, cost attribution. - https://team-x.app/docs/scenario-shift-handoff-playbook/ - Transferring operational responsibility cleanly: handoff document, doctor run, copilot brief, backup-operator checklist. #### Templates Reusable workflow templates that ship with Team-X. - https://team-x.app/docs/templates-overview/ - Where each template fits, what it replaces, customization rules. - https://team-x.app/docs/template-handoff-document/ - Comprehensive operator handoff documentation: workspace overview, active issues, budgets, contacts, decision log, return plan. - https://team-x.app/docs/template-meeting-agenda/ - Agendas for standups, retrospectives, planning, post-mortems, 1:1 check-ins. - https://team-x.app/docs/template-tickets/ - Ten ticket formats: feature, bug, review, docs, test, research, security, performance, deployment, refactor. - https://team-x.app/docs/template-routines/ - Ten routine schedules: code review, data sync, weekly summary, security scan, cost anomaly detection, backup, dependency update, doc sync, health check, performance monitor. #### Developer - https://team-x.app/docs/api-reference/ - The Electron IPC surface: 40 channel families spanning Companies / Employees / Tickets / Goals / Projects / Routines / Meetings / Schedule / Budgets / Authority / MCP / Extensions / Providers / Vault / RAG / Audit / Copilot / Backup / Settings and more. Roughly 220 typed channels with request and response interfaces in the @team-x/shared-types package. The events.dashboard one-way push stream carries the DashboardEvent discriminated union (work.started, ticket.assigned, meeting.ended, copilot.insight, etc) from the orchestrator to renderer windows. Two extension entry points: MCP servers (stdio or SSE) and Skills extensions (local folder or GitHub source). Local-only by design; no hosted REST API, no Bearer auth, no api.team-x.app, no outbound webhook receiver. The page explicitly enumerates what is intentionally not in the surface. - https://team-x.app/docs/integration-guide/ - Provider adapters (Ollama, Anthropic, OpenAI, Google, OpenRouter, Groq, Together, Fireworks, OpenAI-compatible), MCP server registration over stdio and SSE, Skills installation via local folder or GitHub source, workspace export and import as .tx-pack archives, audit-log streaming via audit.export (CSV / JSON), and local full-machine backup. Local-first; explicitly no cloud bridge, no outbound webhooks, no native SaaS connectors. Privacy tier ceiling enforced via settings.setPrivacy (workspace refuses cloud providers when maxTier is local). - https://team-x.app/docs/cli-reference/ - Command reference. Team-X has no separate command-line tool; the Command Palette is the command surface. The team-x-ai CLI was removed in v3.5.0. - https://team-x.app/docs/release-signing/ - What a release run checks before it can publish (signature gate, install-launch-uninstall smoke test, SHA256SUMS, build-provenance attestations, SBOM), how to verify a download, and why v3.5.0 ships unsigned. - https://team-x.app/docs/governance/ - How changes reach main and how releases are tagged: rulesets, the four-stage review wall, break-glass, signed release tags. #### Reference - https://team-x.app/docs/whats-new/ - Release notes, newest first, starting with v3.5.0. - https://team-x.app/docs/faq/ - Open-source MIT licensing, hardware requirements, data storage, update model, verifying a download, privacy-tier refusals, the Models tab, contribution path. - https://team-x.app/docs/keyboard-shortcuts/ - Every keybinding: navigation, palette, copilot sidebar, ticket actions, productivity shortcuts. - https://team-x.app/docs/glossary/ - Definitions for every concept: role specs, levels, runtimes, routines, doctor, copilot, autonomy, vault, FTS5, privacy tiers. - https://team-x.app/docs/troubleshooting/ - Provider connection failures, runtime stalls, agent loop budget exhaustion, file save issues, log paths. - https://team-x.app/docs/accessibility-guide/ - Keyboard-only operation, screen-reader support, color contrast, motion-reduction, focus management. WCAG 2.1 AA baseline. ### Editorial - https://team-x.app/blog/ - Long-form posts. RSS at https://team-x.app/rss.xml. - https://team-x.app/notes/ - Field Notes weekly newsletter. Free, weekly, every Thursday at 9am ET. RSS at https://team-x.app/notes/rss.xml. Subscribe via the form on the page; the backend is a Cloudflare Worker (team-x-newsletter-worker) backed by D1, sending through Resend. Double opt-in, one-click unsubscribe, no tracking pixels, no URL redirect wrappers. The three flow pages (https://team-x.app/notes/check-inbox/, https://team-x.app/notes/confirmed/, https://team-x.app/notes/unsubscribed/) are noindex transient destinations users see only inside the subscribe / confirm / unsubscribe flow. ## Blog and Field Notes The Team-X blog publishes long-form posts on agentic systems, role-spec design, local-first architecture, and what building Team-X in the open has turned up. 11 posts are published as of October 8, 2026. Field Notes, the weekly newsletter, has 1 issue in its archive. This document does not index them. The complete archive, one entry per post with its date, standfirst, section outline, and FAQ, is maintained at: - Complete archive: https://team-x.app/long-llms.txt - Blog index: https://team-x.app/blog/ - Blog RSS: https://team-x.app/rss.xml - Field Notes index: https://team-x.app/notes/ - Field Notes RSS: https://team-x.app/notes/rss.xml ## Editorial voice The site voice is intentionally specific, stakes-first, and source-linked. Every factual claim links to a primary source. The writing avoids: - Marketing language ("delight", "magic", "powerful", "robust", "comprehensive", "seamless", "intuitive", "unleash", "empower", "reimagine", "elevate", "transform"). - Em-dashes and en-dashes (replaced with regular hyphens, colons, semicolons, commas, or sentence splits). - Stock photo people, isometric illustrations, generic three-column icon-circle feature grids. The aesthetic is **Command Console** (re-based 2026-06-28), an exact mirror of the Team-X desktop app's own design system: command software you operate, built like Pioneer DJM-grade hardware, with Apollo flight-console status discipline and Bloomberg-terminal information density. Display type is Archivo (ALL-CAPS placards, variable width 110-125). Body and UI text is Public Sans. Telemetry, LCD readouts, labels, and serials are Departure Mono (pixel mono). Code and token streams are Iosevka. There is deliberately no serif anywhere. The palette is the Carbon Pro ramp: carbon `#050505` chassis with void-black `#000000` display wells, a silver text ramp (platinum `#F5F5F5` down to muted `#888888`), and armed red `#AA2024` as the single brand accent. LED lamp semantics are fixed: green `#41E25E` = GO, amber `#FFB000` = HOLD, blinking red `#FF4438` = WARN, steady dark red `#C8453E` = NO-GO, teal `#58C4BC` = SCOPE. Steady armed red always means LIVE, never error. Decoration vocabulary: four-layer raised-hardware depth (chassis, faceplate, recessed well, raised control), hex socket bolts, brushed-aluminum stripe headers with stencil kickers and serial numbers, lamp tiles carrying stencil status words, LCD phosphor wells, IEC VU segment meters, machined-cap buttons, and bat-lever switches, plus the Team-X X sigil as watermark. The site ships two designed themes: Night Ops (brushed black, default) and Day Shift (silver anodized); displays (LCDs, VU meters, lamps) stay void-black in both. Motion is mechanical: LED strikes, 1Hz acknowledge blinks, VU ballistics, and 1px cap travel; there is no scroll-jacking, no parallax, and no animated headlines. Every animated element on the site is a real React island rendering truthful simulated telemetry, not decorative animation. ## Source code - Repository: https://github.com/git-rocky-stack/team-x - License: MIT - https://github.com/git-rocky-stack/team-x/blob/main/LICENSE - Contributing: https://github.com/git-rocky-stack/team-x/blob/main/CONTRIBUTING.md - Issues: https://github.com/git-rocky-stack/team-x/issues - Releases: https://github.com/git-rocky-stack/team-x/releases ## Parent brand Strategia-X is Rocky Elsalaymeh's parent brand. The parent site is https://www.strategia-x.com. ## Strategia-X Ecosystem Team-X is one of nine sibling products in the Strategia-X family. The other eight are: - Strategia-X AI (https://strategia-x.ai): AI-powered analytics and strategy platform, the core intelligence layer of the Strategia-X suite. - Android Architect (https://www.android-x.com): Android app development accelerator and clean-architecture toolkit. - Lumina Studio (https://www.lumina-os.com): Creative production studio for visual and media work. - ClipForge (https://clip-forge.io): Video clip creation and repurposing tool for content workflows. - ElementForge (https://www.element-forge.app): UI component and design-element builder. - ResumeForge (https://resume-forge.app): Resume and career-document builder with AI-assisted formatting. - STX.1 (https://stx-1.com): Performance tracking and personal analytics dashboard. - Dynasty-X (https://www.dynasty-x.com): Fantasy sports management platform built for serious operators. - WealthWise OS (https://www.wealthwiseos.com): Personal finance and wealth-management operating system.