代码编织代理

Production / hardened mode: require Vault-configured providers only.

export CODETETHER_DISABLE_ENV_FALLBACK=1 ```

Install

Also install the FunctionGemma model (~292 MB)

curl -fsSL https://raw.githubusercontent.com/rileyseaburg/codetether-agent/main/install.sh | sh -s -- --functiongemma ```

To also install FunctionGemma, run the script with -FunctionGemma

iwr https://raw.githubusercontent.com/rileyseaburg/codetether-agent/main/install.ps1 -OutFile install.ps1 .\install.ps1 -FunctionGemma ```

Quick Start

1. Configure Provider Credentials

Provider API keys are loaded from HashiCorp Vault first. For local development, CodeTether also detects common env vars and local AWS credentials unless CODETETHER_DISABLE_ENV_FALLBACK=1 is set.

```bash export VAULT_ADDR="https://vault.example.com:8200" export VAULT_TOKEN="hvs.your-token"

Environment variables for history persistence (optional)

export CODETETHER_HISTORY_S3_ENDPOINT="http://localhost:9000" export CODETETHER_HISTORY_S3_BUCKET="codetether-history" export CODETETHER_HISTORY_S3_ACCESS_KEY="minioadmin" export CODETETHER_HISTORY_S3_SECRET_KEY="minioadmin" ```

Configuration

~/.config/codetether-agent/config.toml:

```toml [default] provider = "anthropic" model = "claude-sonnet-4-20250514"

[ui] theme = "marketing" # marketing, dark, light, solarized-dark, solarized-light

[session] auto_save = true

[lsp] [lsp.servers]

Environment Variables

Cognition APIs

When running codetether serve, perpetual persona swarms with SSE event stream:

Auth workflows

codetether auth login --server https://api.codetether.run codetether auth register --server https://api.codetether.run codetether auth cookies --provider gemini-web --file cookies.txt

TetherScript: Zero-Rust Plugin Platform

TetherScript is CodeTether's scriptable extension layer. Third parties can add new providers, enforce custom policies, and build automation workflows without writing Rust, without recompiling, and without restarting the agent. Drop a .tether file anywhere, call it through the tetherscript_plugin tool, and the running agent executes it immediately.

Why it's different

TetherScript plugins run inside the agent process with access to the full built-in surface: HTTP, filesystem, JSON, JavaScript evaluation, and live browser rendering — no sandbox limitations by default.

Quick example — call a local LM Studio model without touching Rust

{
  "path": "examples/tetherscript/lmstudio_gemma.tether",
  "hook": "chat",
  "args": ["explain this codebase", "gemma"]
}

The plugin (lmstudio_gemma.tether) uses http_request to call http://localhost:1234/v1/chat/completions — wiring an entirely new LLM backend with ~55 lines of script.

Inline scripts — the agent can write and run its own tools dynamically

{
  "source": "fn validate(x) { return Ok(x > 0) }",
  "hook": "validate",
  "args": [42]
}

The source field lets the LLM generate and execute logic in-band — a self-extending agent pattern.

Built-in plugins

Built-in TetherScript functions

• HTTP: http_get, http_post, http_request
• Filesystem: fs_read, fs_write, fs_exists, fs_list
• JSON: json_parse, json_encode, json_encode_pretty
• JS / Browser: js_eval, browser_render, browser_eval_js, browser_snapshot, browser_query_selector
• Strings: .contains(), .split(), .replace(), .upper(), .lower()

See docs/plugin_pattern.md for the full contract, return value conventions, and testing patterns.

---

my-ruby-lsp = { command = "ruby-lsp", args = ["--stdio"], file_extensions = ["rb"] }

[lsp.linters] eslint = { enabled = true } ruff = { enabled = true } biome = { enabled = false } stylelint = { enabled = true } ```

Project-local codetether.toml policy fields are sanitized until the current workspace is trusted. Use codetether config project status to inspect the current workspace, codetether config project trust to allow project-local sandbox/approval/permission policy, and codetether config project untrust to remove that trust. Trust records are stored outside the repository and keyed by the canonical workspace path hash.

VS Code (Workspace-Level)

Add .vscode/mcp.json to your workspace:

{
  "servers": {
    "codetether": {
      "command": "/home/riley/.cargo/bin/codetether",
      "args": ["mcp", "serve"],
      "env": {
        "RUST_LOG": "error"
      }
    }
  }
}