# Atuin for Teams

Atuin helps you and your team share your thread context. You can create an org
in the Web UI.

TODO SCREEN RECORDING HERE

## Sharing threads

You can share threads with your organization either on a per-thread basis,
per-workspace, or you can choose to share all your threads with your org.

Sharing individual orgs on a per-thread basis is easiest through the Web UI.

TODO SCREEN RECORDING HERE

### Workspaces

To share threads in workspaces (such as git repos, or project directories),
make sure that an `.atuin.lua` is present in the workspace and configure the
orgs you want to share with:

```lua
-- atuin:version=1
atuin.config = {
  -- ...
  orgs = { "acme-inc" },
}
```

Visit the [reference](/reference/config/atuin-lua/) for the workspace
configuration file for more details.

### Global sharing

Create an `~/.atuin/atuin.lua` file:

```lua title="~/.atuin/atuin.lua"
-- atuin:version=1
atuin.config = {
  upload = true,
  orgs = { "acme-inc" },
}
```

Your threads will be uploaded, and automatically shared with every member of
`acme-inc`.

## Agentic workflows

We **highly** recommend installing Atuin's MCPs via `atuin setup --only --mcp`,
as that will allow your agent to receive context from your whole team. Your
agents will know everything your whole team is doing.

<VHSTape title="atuin setup --only --mcp finds opencode and Kiro on this machine, and connects Atuin's MCP server to both.">
  Set FontSize 20
  Set Height 300
  Hide
  # Two agents for setup to find: stand-ins for opencode's and Kiro's programs, on a PATH of just
  # them, Atuin and the system's tools, so the agents of the machine running the build stay out.
  Type ` mkdir ~/agents && touch ~/agents/opencode ~/agents/kiro-cli && chmod +x ~/agents/* && export PATH="$HOME/agents:$commands[atuin]:h:/usr/bin:/bin" && clear`
  Enter
  Sleep 1s
  Show
  Sleep 500ms
  Type "atuin setup --only --mcp"
  Sleep 500ms
  Enter
  Sleep 3s
</VHSTape>

For more details, see the [MCP getting started page](/getting-started/basic-usage/#mcp-support).