Quick start

What you need

• A Terebyte account. A free account has 5 GB, which is plenty to try this.
• The computer where the agent runs, with Node.js 20 or newer (for the JavaScript kit) or Python 3.9 or newer (for the Python kit).
• Five minutes. You'll type one 6-character code; you never copy a key.

1. Make a room (optional)

A room is a folder with its own key. An agent only ever reaches the rooms you open to it.

• To use a folder you already have: in Files, open the folder's menu and choose Make this folder a room. Nothing is re-encrypted or uploaded again; the folder simply gets its own key.
• Or skip this step. When you approve the agent in step 3, you can give it a new, empty room named after it.

2. Pair the agent

On the agent's computer, run one of these:

npx terebyte pair --name Claude

pip install terebyte
terebyte pair --name Claude

The program makes the agent's own keys (they stay in ~/.terebyte and are never shown) and prints a code:

Your code: 4K7QXM

In Terebyte, open Rooms → Connect an agent, and type it (it works for 10 minutes).

4K7QXM is an example. Leave the program running: it waits for your approval.

By default the program asks for read, add, change, for today. You can ask for something else with --can and --length (see the kits), but you decide on the approval screen either way.

3. Approve the door

1. In Terebyte, open Rooms in the sidebar.
2. Under Connect an agent, type the code and press Connect.
3. Terebyte shows the agent's name, the computer it runs on, and what it asks for. Check the name.
4. Choose the Room (a new, empty room, or one of yours), what it may do (Read, Add, Change, Delete, Share) and For how long (1 hour, Today, 30 days, Until closed).
5. Press Approve.

On the agent's computer, the program says:

Done: a door to “Claude”. Run `npx terebyte mcp` from your agent's tool.

4. Write a file

echo "# Hello from my agent" > hello.md
npx terebyte put hello.md Notes/hello.md

The file is encrypted on the agent's computer before it leaves. Notes is made inside the room if it isn't there. With Python, the same command is terebyte put hello.md Notes/hello.md.

5. Read it back

npx terebyte ls
npx terebyte cat Notes/hello.md

ls lists every file in the room with its size; cat prints the file, decrypted on this computer.

6. See it in Terebyte

• Open the room in Files: Notes/hello.md is there.
• On Rooms, the agent's card shows what it did under Activity and Undo. Undo puts back everything it did since a time, or one file.

7. Give it to your AI agent

To let Claude Code use the room through its tools:

claude mcp add terebyte -- npx terebyte mcp

With the Python kit: claude mcp add terebyte -- terebyte mcp. Then ask Claude what rooms it can reach. See the MCP server.

If something goes wrong