Requirements

Trama is a VS Code extension that works with a coding agent. Before installing it, check that the machine has what follows.

What you need

• VS Code 1.106 or later. It is the only editor Trama supports.
• A supported platform. Linux (x64), macOS (Apple silicon) or Windows (x64). Windows is in preview: trama.exe is not signed, so SmartScreen or an antivirus may warn the first time it runs.
• omp, the only agent Trama supports. Trama runs every agent job with omp. If omp is missing, Trama offers to install it with omp’s official installer; see First run of omp.
• An account with a model provider, logged in through omp, so the agent has a model to work with.
• The GitHub CLI (gh), only for Team. Manager mode and Team, experimental, read your GitHub Project through gh, which has to be installed and logged in with access to Projects. Everything else works without it.
• git, only for Solo mode. Solo mode keeps Trama’s files out of git, so the folder has to be a git repository.

What Trama does with your code

Trama never calls a language model and never reads your code: the agent does, through Trama’s command line. Trama sends nothing off the machine, apart from the notification you can turn on to be told, away from the computer, that the agent finished or waits for you (see Away notifications), and the read-only requests to your GitHub Project that Team makes through gh.

Check that omp is ready

Once Trama is installed (see Install the extension), one look at Settings tells whether the machine has omp and a provider.

Check that omp answers

Open Settings from the side menu. The box at the top of the omp group reads omp <version> answered with <N> models. when omp is found and working, and Providers lists the model providers you are connected to.

Enlarge screenshot:

1. 1
2. 2
3. 3

1. omp answered
2. Connected provider
3. Log in to a provider

Next

Install the extension.