Frequently asked questions

Common questions about Team-X v3.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 57 hand-written 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.

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-seven 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. 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.

What providers are supported?

Ten: 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.

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 2,150 passing tests on commit zero; new code should keep it green.