Skip to content

Squid v0.1 — Initial release

Choose a tag to compare

@haebin haebin released this 23 Jul 22:27
· 415 commits to main since this release

Squid v0.1

Agent-Squid is a meta harness tool which lets you run Claude Code, OpenAI Codex, Cursor Agent, OpenCode, Pi coding agents locally with multiple providers, such as, Claude, GPT, Cursor, OpenCode, NVIDIA, DeepSeek, local LLMs via one browser UI. Your agents still run on your own machine, with your repo, shell tools, credentials, and native CLI sessions. Squid gives those sessions names, global search, history, queues, controls, and phone/tablet access.

Quick Start

  1. Install at least one supported CLI and check whether you can use it (/login):
Backend CLI Install
Claude Code claude curl -fsSL https://claude.ai/install.sh | bash
OpenAI Codex codex curl -fsSL https://chatgpt.com/codex/install.sh | sh
Cursor Agent cursor-agent curl -fsS https://cursor.com/install | bash
OpenCode opencode curl -fsSL https://opencode.ai/install | bash
Pi pi curl -fsSL https://pi.dev/install.sh | sh
  1. Install and run AgentSquid!
curl -fsSL https://agentsquid.ai/install.sh | bash
  1. Open in your browser:
http://127.0.0.1:8000

Create agents in the UI. An agent is a named config:

agent name (@agent) = harness (Claude Code) + provider (Claude) + model (claude-sonnet-5) + working directory (CLAUDE.md, etc.)

Supported harnesses and providers

Squid separates the coded CLI integration from the model endpoint/account:

  • Harness — the local coding-agent CLI Squid drives: Claude Code, OpenAI Codex, Cursor Agent, OpenCode, or Pi.
  • Provider — the account or endpoint behind the harness: Claude, GPT, Cursor, OpenCode, NVIDIA NIM, DeepSeek, or a local models supporting standard APIs.
  • Agent — your named lane in the UI: name = harness + provider + model + model working directory.

Provider configuration lives under providers: in ~/.squid/squid.yaml. Native subscription providers work with zero config where the CLI is already logged in; API-key providers such as NVIDIA NIM, DeepSeek, and local OpenAI-compatible endpoints are configured once and can be reused by compatible harnesses.

Highlights

  • Named topic and agent lanes with durable sessions: #topic@agent
  • Parallel fresh-context prompts: #topic@agent!
  • Limited lookback for goldfish mode: #topic@agent!3
  • Side-by-side work across Claude Code, Codex, Cursor Agent, OpenCode, Pi, and compatible custom provider endpoints
  • Context pins for using selected responses as explicit context for other topics, agents and sessions.
  • Live response progress, queue state, status output, and tool-call display
  • Per-prompt input, output, cache, cost, duration, and quota signals where the harness/provider exposes them
  • Provider-scoped real-time quota gauges, including static gauges for free-tier or local providers
  • Topic-scoped Git diff tracking through code_roots shared across agents.
  • Queue and process controls: stop, stop-all, drain, clear, compact, and reset
  • Global, topical, by route (#topic@agent+) search
  • Topics view with searchable lanes, topic actions, and browser back navigation after opening a topic
  • Browser UI on desktop, phone, and tablet via optional Tailscale HTTPS access with /remote QR code
  • Persistent user configuration, database, context, and logs under ~/.squid/

See the README for command syntax, agent creation, provider configuration, remote access, and security details.