SWIFTAGENT FIELD NOTES

Local control,
clear boundaries.

TAGGED QUICKSTART

terminal

gh release download v0.6.0 --repo OthmaneBlial/swiftagent \
  --pattern 'swiftagent-v0.6.0.tar.gz' --pattern 'SHA256SUMS'
shasum -a 256 -c SHA256SUMS --ignore-missing
tar -xzf swiftagent-v0.6.0.tar.gz
cd swiftagent-v0.6.0
make install-release
make start-release

Verify the GitHub provenance attestation as documented in the release installation guide before running the bundle.

ADAPTERS

Native protocols behind one contract.

SwiftAgent detects Claude Code, Codex, OpenCode, a configured ACP v1 process, and a tested restricted command. Every adapter declares its real support for streaming, tools, approvals, questions, plans, usage, model discovery, resume, cancellation, and safety controls. Missing support removes or disables the corresponding UI instead of emulating it.

RUNTIME

One local control plane.

The React app talks to FastAPI through REST and WebSocket events. A selected adapter translates its native process stream into versioned normalized events while keeping bounded native identity for inspection. SQLite stores the run, and Git evidence records the workspace baseline and resulting change set.

RECEIPTS & HANDOFFS

Review before context moves.

A Local Run Receipt separates agent claims from explicit verification evidence. “Continue with another agent” creates a new run only after a visible, expiring preview. Credential-like values, native session IDs, environment dumps, sensitive paths, and hidden reasoning are excluded or redacted. Pattern redaction is defense in depth, so the user remains responsible for reviewing the preview.

SAFETY NOTES

Native safety is not process isolation.

Codex or ACP approval controls belong to the native adapter. SwiftAgent strict isolation is a separate Linux bwrap layer and fails before launch if unavailable. fallback does not isolate the selected agent from files accessible to the local user. Claude Code and OpenCode support also differs; inspect the local capability cards before sensitive work.

SwiftAgent is loopback-only by default and has no multi-user authentication. Do not expose it remotely without a trusted authentication and transport-security layer.

DEMO

Reproducible, bounded, honest.

make demo-prepare creates separate clean workspaces for Claude Code, Codex, and OpenCode. make demo-verify proves the fixture’s failing baseline and passing reference without calling a provider. The published animation uses local protocol fixtures and is not presented as a model-quality benchmark.

FOCUSED GUIDES

Start with the agent you use.

Claude Code, Codex, and OpenCode each have a focused workflow and boundary page. Contributors can connect any installed ACP v1 agent through Adapter API 1.0.