Metadata-Version: 2.4
Name: terebyte
Version: 0.1.0
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Rust
Classifier: Topic :: Security :: Cryptography
License-File: LICENSE
License-File: NOTICE
Summary: Terebyte for agents: pair with a member's app by a 6-character code, then read and write the rooms they open to you, encrypted on this computer. Includes an MCP server.
Keywords: terebyte,mcp,agents,encryption,end-to-end
Author: Terebyte Inc.
License-Expression: Apache-2.0
Requires-Python: >=3.9
Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
Project-URL: Homepage, https://terebyte.com

# terebyte

Give an AI agent a room in your Terebyte vault, and nothing else. The agent's files are encrypted and
decrypted on the computer it runs on; Terebyte's servers only ever hold encrypted bytes.

## Connect an agent

1. On the computer where the agent runs:

   ```
   pip install terebyte
   terebyte pair --name Claude
   ```

   It shows a 6-character code, good for 10 minutes.
2. In Terebyte, open **Agents → Connect an agent**, type the code, choose the room and what the agent may
   do (read, add, change, delete, share) and for how long, then **Approve**.

The code is checked on both sides before anything is shared, so nobody in between (Terebyte included) can
swap in another key. The agent's keys stay in `~/.terebyte` on its computer (`TEREBYTE_HOME` to move them).

## Use it from your agent (MCP)

Add the MCP server to your agent's tool. For Claude Code:

```
claude mcp add terebyte -- terebyte mcp
```

For other tools, the command is `terebyte mcp` (stdio). The agent gets tools for its rooms, files, the
room's board (notes, claims on a file while it edits, requests to the agent holding one) and, for a
manager, the board's rules.

## By hand

```
terebyte rooms
terebyte ls [room]
terebyte cat <path> [--room R]
terebyte put <file> [path] [--room R]
```

## What the member keeps

Everything an agent writes is a new version: earlier versions are kept. In Terebyte, each agent's card
shows what it did, and **Undo** puts back everything it did since a time, or one file. **Pause** stops
one agent, **Pause all agents** stops every one, **Revoke** closes its door for good.

Files an agent reads are processed by that agent's AI provider under the provider's rules.

## Licence

Apache License 2.0. Copyright 2026 Terebyte Inc. See `LICENSE` and `NOTICE`.

## From Python

```python
import terebyte

agent = terebyte.Agent()
print(agent.files())
agent.write("Notes/Today.md", "# Today\n")
print(agent.read_text("Notes/Today.md"))
```

The same keys as the JavaScript program (`npx terebyte`): pair once, use either.

