Installation
Follow the steps below to install Tzara, the Telekinesis Physical AI Agent, into Visual Studio Code.
Tzara installation walkthrough
Visual Studio Code Extension Installation
- Open Visual Studio Code and navigate to the Extensions view by clicking on the Extensions icon in the Activity Bar on the side of the window or by pressing
Ctrl+Shift+X(Windows/Linux) orCmd+Shift+X(macOS). - In the search bar, type "Tzara" by Telekinesis.
- Click on the "Install" button.
API Key Configuration
Tzara requires 2 API keys to function: the TELEKINESIS_API_KEY for accessing the Telekinesis SDK and the ANTHROPIC_API_KEY for accessing the underlying language models.
- Get your Telekinesis API key at platform.telekinesis.ai/api-keys
- Get your Anthropic API key at console.anthropic.com/settings/keys
Set the API Keys
Select the tab matching your shell and run the commands to set both keys. On macOS / Linux, you can run echo $SHELL to check which shell you're using.
# Persist for future sessions
setx ANTHROPIC_API_KEY "<your_key>"
setx TELEKINESIS_API_KEY "<your_key>"
# Also set for the current session
$env:ANTHROPIC_API_KEY="<your_key>"
$env:TELEKINESIS_API_KEY="<your_key>"echo 'export ANTHROPIC_API_KEY="<your_key>"' >> ~/.bashrc && echo 'export TELEKINESIS_API_KEY="<your_key>"' >> ~/.bashrc && source ~/.bashrcecho 'export ANTHROPIC_API_KEY="<your_key>"' >> ~/.zshrc && echo 'export TELEKINESIS_API_KEY="<your_key>"' >> ~/.zshrc && source ~/.zshrcecho 'set -gx ANTHROPIC_API_KEY "<your_key>"' >> ~/.config/fish/config.fish && echo 'set -gx TELEKINESIS_API_KEY "<your_key>"' >> ~/.config/fish/config.fish && source ~/.config/fish/config.fishINFO
On Windows, setx updates future PowerShell sessions. If you open a new terminal, the keys will already be available.
Verify the API Keys
Print the values of both keys to confirm they are set:
echo $env:ANTHROPIC_API_KEY
echo $env:TELEKINESIS_API_KEYecho $ANTHROPIC_API_KEY
echo $TELEKINESIS_API_KEYYou should see the values of both keys printed in the terminal.
Key not found?
If the key is not found or appears empty, your terminal session has not picked up the new environment variables yet. Close all VS Code windows, restart VS Code, and open a fresh terminal — the updated environment will then be loaded.
Run Tzara in Visual Studio Code
To test that Tzara is installed and configured correctly:
- Open Visual Studio Code
- Open the Command Palette by pressing
Ctrl+Shift+P(Windows/Linux) orCmd+Shift+P(macOS). - Type:
Tzara - Select
Tzara: Open Chat. This will open a new chat interface where you can interact with Tzara. - Try typing a simple instruction like
Hi Tzara!and see if you receive a response. If you do, then Tzara is successfully installed and ready to use!
TIP
Tzara is always available on the top right corner of Visual Studio Code. You can click on the Telekinesis icon to open the chat interface at any time.
Uninstallation
To uninstall the Tzara Visual Studio Code extension, follow these steps:
- Open Visual Studio Code and navigate to the Extensions view by clicking on the Extensions icon in the Activity Bar on the side of the window or by pressing
Ctrl+Shift+X(Windows/Linux) orCmd+Shift+X(macOS). - In the search bar, type "Tzara" by Telekinesis.
- Click on the "Uninstall" button.

