Frequently asked questions

Common questions about Team-X v3.4.0. If you don’t see yours here, the GitHub issues tracker is the authoritative answer source.

What is Team-X?

Team-X is an open-source, local-first desktop app for running AI-agent organizations. You hire employees from a curated catalog of 55 hireable role specs, build a real org chart, set goals, file tickets, hold meetings, and watch the team operate live in a five-subview cockpit. The unit of work is the role, not the prompt. See the launch manifesto for the fuller argument.

Is Team-X free?

Yes. Team-X is MIT-licensed and open-source on commit zero. There is no paid tier, no freemium model, no compute budget you have to top up. The only money you might spend is to your own LLM provider if you choose a cloud tier. Running fully on Ollama costs nothing.

What do I need to run it?

Resource	Recommended
OS	Windows 10/11, macOS 11+, Ubuntu 20.04+ or comparable
RAM	16 GB (8 GB minimum)
Disk	500 MB for the app, plus space for your vault and SQLite database
Network	Optional. Required only for cloud providers and update checks.

For Ollama, plan an additional 5-15 GB for the model weights depending on which model you pull. llama3.1:8b is roughly 4.7 GB.

The Linux AppImage will not start. What do I do?

The AppImage runtime needs FUSE 2. Install libfuse2 (or libfuse2t64 on Ubuntu 24.04, fuse-libs on Fedora), or run it with ./Team-X-3.4.0-x86_64.AppImage --appimage-extract-and-run. The .deb package needs no FUSE and resolves its own dependencies.

Does Team-X phone home?

No. There is no analytics, no telemetry, no auto-update phone-home. Update checks are user-triggered; the app pulls release information from GitHub Releases on demand. The only outbound traffic is the LLM provider calls you have explicitly configured. See the privacy posture page for the full inventory of network behavior.

How are API keys stored?

In the OS keychain (macOS Keychain, Windows Credential Manager, Linux Secret Service via keytar). Keys are never written to plaintext config files or the SQLite database.

Can I run Team-X fully offline?

Yes. Configure Ollama as your only provider, set your privacy tier to Local only, and the app runs without ever opening a socket to a third-party host. See Configuring providers.

What roles ship in the box?

Fifty-five hireable roles across six hierarchy levels: Officer, Senior Management, Management, Supervisor, Lead, and IC, plus two hidden system roles for the agentic loop and copilot service, for 57 specs in total. The full catalog is browsable at /roles. Each role spec is hand-written, not generated, and lives in role-packs/strategia-official/roles/{level}/*.md.

Can I customize the role specs?

Yes. Role specs are markdown files with frontmatter. Override the frontmatter or extend the body prompt to shape voice, capabilities, or tool access. Changes take effect on the next agent turn.

Can the agents access the internet?

Only if you give them a tool that does. Out of the box, the agents have access to the read-only org query tools (employees, tickets, projects, meetings, vault, events) and the workspace file tools when execution is enabled. Web access is opt-in via MCP server configuration.

How do I control what agents spend?

Budgets. Set warnings, hard caps, and escalation thresholds across company, employee, runtime, and routine scopes, with a full ledger of what was spent. Per-employee token caps and approval gates add finer control, and the Telemetry tab breaks cost down by provider and model so you can see where the money goes before you cap it.

What is the Task Planner?

A write-side planner for Management-and-above agents. They can decompose a project into tickets and delegate subtasks with a deterministic workload score, but no ticket is created until you clear an amber confirmation gate. Four guardrail settings live in Settings > Task Planner.

Can I cancel a running agent?

Yes. Any agentic-loop run can be canceled mid-flight, and every run already terminates under hard step, token, and wall-clock budgets (defaults 8 / 8,000 / 120s, all configurable in Settings > Agentic Loop).

Can employees work together?

Yes. Agents message colleagues through built-in employee-to-employee tools, join tickets and meetings as participants, and hand work off through the Task Planner. A lead can delegate to an IC without you relaying the message.

What providers are supported?

Nine: Ollama (local), Anthropic, OpenAI, Google, Groq, OpenRouter, Together, Fireworks, plus any OpenAI-compatible endpoint. Privacy tiers gate which can be used. See Configuring providers.

How do I back up my data?

Settings > Backup produces a single archive containing the SQLite database and the file vault, with a manifest validated on restore. There is no cloud backup; your data lives on your machine.

Can I share a workspace with another operator?

Export a whole company as a .tx-pack archive, then preview and import it on another machine in a single transaction. The Autonomy view’s Access module governs operator and sharing posture. There is no hosted multi-user server; sharing means moving the workspace, not syncing it to a cloud.

Can I export my data without a full backup?

Yes. The audit log exports to CSV or JSON (Audit > Export), Telemetry and Copilot insights export the same way, and every vault artifact is already a plain file on disk (txt, md, csv, json, html, docx, xlsx, pptx). Your data is yours to take at any granularity.

How do I uninstall and remove my data?

Uninstall the app through your OS as usual. Your workspace data is a local SQLite database plus the file vault in the app’s data directory; delete that directory to remove every trace of local data. Provider keys live in the OS keychain and can be cleared from Settings > AI Providers or your keychain manager.

How do updates work?

User-triggered. Open About > Check for Updates to query GitHub Releases. If a new version is available, you download and install the new binary yourself. The app never updates silently in the background.

How do I report a bug?

Open an issue on GitHub. Include your OS, the Team-X version, and the relevant audit-log excerpt (Audit > Export). The audit log contains no chat content, only event metadata.

How do I contribute?

Read CONTRIBUTING.md in the repo. Pull requests are welcome. The test suite has 3,521 passing tests across 296 files; new code should keep it green.