Skip to content
farzaiPublic

About

Connect your own AI agent to web apps: a local worker that runs app tasks as fresh, sandboxed agent sessions.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Tether

Connect your own AI agent to web apps.

Tether is a small program you run on your own computer. Web apps that support it put AI tasks in a queue for you; Tether picks them up and runs each one as a fresh, sandboxed agent session (Claude Code first), with only the tools the task needs. You steer everything from the app's web page. The app never runs or pays for a model, and your agent never gets more access than you allow.

npx @farzai/tether connect https://paper.farzai.com
npx @farzai/tether start

Status: early. From a checkout, bun run tether <command> runs the CLI: connect <app-url>, start [--concurrency <n>], status, apps, disconnect <app>, logs, doctor and service install|uninstall|status. It needs Claude Code (2.1.325 or later, signed in); tether doctor checks that. Single binaries are built by the release workflow but not published yet. See docs/spec.md for the product spec and docs/protocol.md for Tether Protocol v1, which app servers implement. An app server can check itself with the conformance suite: bun run conformance <app-url> from a checkout of this repository (see the protocol's "Conformance testing" section).

What a task can do on your computer

Each task runs as a fresh claude -p session in an empty temporary directory that is deleted afterwards. The session gets only the app's own MCP server, only the tools both the app asked for and your policy allows (by default only WebSearch; never WebFetch or Bash unless you add them), no user settings, hooks, plugins, skills or CLAUDE.md, and an environment without your other variables. Tether checks the session Claude Code reports and stops it if it got more.

Your policy lives in ~/.tether/policy.json (or $TETHER_HOME). Every field is optional:

{
  "tools": ["WebSearch"],
  "max_task_usd": 1,
  "max_timeout_s": 1800,
  "daily": { "tasks": 100, "usd": 10 },
  "apps": { "https://paper.farzai.com": { "tasks": 20, "usd": 2 } }
}

An app can ask for less than this, never more. WebFetch is off by default because a page fetched for an app can be on your own computer or network (127.0.0.1, your router, a cloud metadata address); add it only for apps you trust. tether start warns while your policy allows WebFetch, Bash or PowerShell. A task can spend up to one turn past its budget, since Claude Code checks the budget between turns.

Device credentials go in the macOS keychain, or the Secret Service keyring on Linux (through secret-tool). Where there is none (Windows, or a Linux without an unlocked keyring) they stay in ~/.tether/credentials.json, readable only by you. TETHER_KEYCHAIN=off keeps them in that file.

Running in the background

tether service install runs tether start now and at every login: a launchd agent on macOS (output in ~/.tether/service.log), a systemd user unit on Linux (journalctl --user -u tether), or a Task Scheduler task on Windows. The service gets your PATH and Tether's own variables, but not ANTHROPIC_API_KEY: sign Claude Code in with claude auth login for the service to use it. On Windows the task runs through a small .cmd wrapper, which can show a console window at login; closing it stops Tether until the next login. tether logs lists what each task did: app, type, duration, cost and how it ended.

The binaries are not signed yet. On macOS, Gatekeeper blocks a downloaded binary the first time: open it once from Finder with Control-click and Open, or run xattr -d com.apple.quarantine tether.

License

MIT

About

Connect your own AI agent to web apps: a local worker that runs app tasks as fresh, sandboxed agent sessions.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages