THERAID PROJECT

Ephemeral AI agents with real infrastructure isolation.
Mission-specific. Zero lingering access.

View on GitHub
BUILT FOR TEAMS WHO CANNOT AFFORD AGENT INCIDENTS
THE PROBLEM

Most agents are permanent residents.

Broad access. Always running. One mistake and the blast radius is everything. RAID agents are missions. They show up, finish, and leave.

THE NAME

A raid is a mission, not an occupation.

Most agent platforms run persistent processes with broad access. One mistake and everything is exposed.

RAID is the opposite. You define a mission in one YAML file, launch an isolated agent, get the result, and it disappears.

Go in. Do the job. Come home. No permanent footprint.

See the military definition: raid (military).

More on how we build it โ†’

CORE CAPABILITIES
Agents that know when to stop.
Defined by recipe
One YAML file holds persona, tools, policy, secrets, TTL, and contract. New agents without new code.
Infrastructure isolation
Each agent runs in its own container. Control plane never sees keys. Policy enforced at the SDK.
Perfect resume
State, files, and CLAUDE.md are snapshotted. The next raid continues exactly where the last one stopped.
Portable by strategy
Compute, state, and secrets are swappable adapters. Local today. Cloudflare tomorrow. Fly later.
Ephemeral by default
Mission starts. Mission ends. Agent stands down. No lingering access or always-on risk.
Telegram control
One control bot. One bot per agent. Live streams. No dashboards required.
THE FLOW
How it works

1. Write the recipe

One YAML. Mission, tools, policy, TTL, and secrets. That's the entire agent.

2. Send it out

Trigger from Telegram. It boots in full isolation for this mission only.

3. Do the job

Live stream in your bot. Tool calls respect the recipe policy. Container is the boundary.

4. Come home

Results and state are saved. The agent stands down. Next call starts exactly where it left off.
SECURITY BY DESIGN

Security is the foundation, not an afterthought.

AUTH + OWNERSHIP

Trust on first use + strict ownership

Telegram user allowlist or first-caller claim. You can only control agents you created. Rate limits and audit-friendly ownership built in.

POLICY ENFORCEMENT

Authoritative at the SDK hook

Smart defaults + recipe overrides enforced via Claude Agent SDK PreToolUse. Read and workspace write allowed. Shell, publish, and network tools gated explicitly. Container is the boundary.

SECRET HYGIENE

Control plane never sees keys

Secrets are resolved by name only at compute time. Each agent container receives only its own recipe secrets. Control plane is deliberately dumb.

EPHEMERAL + AUDITABLE

The agent comes home

Short TTLs. Complete infrastructure isolation during the mission. Clean state snapshots so the next raid starts exactly where the last one left off.

THE LANDSCAPE

RAID vs the alternatives

How RAID PROJECT stands apart from the other major open-source agent platforms.

DimensionOpenClawNanoClawHermes AgentRAID PROJECT
LifecycleAlways-onLong-runningContinuousEphemeral. Execute then stand down.
IsolationApp permissionsContainerMultiple backendsInfrastructure level + adapters
DefinitionSkills & pluginsOn-demand skillsSelf-generatedSingle YAML mission contract
ResumeAlways presentPer-agent memoryLong-term memorySnapshot on return. Next raid resumes.
RiskHighMedium-lowMediumLowest. Short TTL + full isolation.
Best forExplorersPersonal usePersonal companionsTeams that send agents and bring them home.
NO CODE REQUIRED
Examples.
dev-agent.yaml
Code changes and PRs. Per-repo grants.
TTL: 6h
sdr-agent.yaml
Outreach. gmail.send allowed.
TTL: 1h
researcher.yaml
Reads, reasons, saves notes. Resumes cleanly.
TTL: 30m
ops-agent.yaml
Shell + k8s. Policy gated. Never self-deploys.
TTL: 24h
TRUE OPEN SOURCE

Built to production standards, not released as an experiment.

  • โ†’ MIT license. Use and extend freely.
  • โ†’ Strategy interfaces are the only extension surface you need
  • โ†’ Real tests and smoke scripts that exercise policy and the real Claude SDK
  • โ†’ Local-first runnable with zero cloud (npm run serve)
  • โ†’ Recipes are the product surface. Contribute new ones with zero code.
  • โ†’ Small core, explicit seams, lazy but finished

Why the raccoon ๐Ÿฆ? Raccoons are legendary raiders โ€” clever, stealthy, and masters of the quick in-and-out job. RAID agents do exactly that.

Built by Eliran Suisa.

๐ŸŒ
COMMON QUESTIONS

Frequently asked questions

Answers for teams evaluating secure agent platforms.

What is the RAID Project?โŒ„

RAID is an open source platform for running ephemeral AI agents with real infrastructure isolation. A mission is defined in one YAML file (the 'recipe'). The agent boots in full isolation, performs only what the policy allows, returns results, and then stands down completely. No lingering processes or access remain.

How is RAID different from tools like OpenClaw, AutoGen, or CrewAI?โŒ„

Most frameworks create long-running or always-on agents. RAID agents are short-lived by design. They receive a complete contract (persona, tools, policy, TTL, secrets) and execute inside isolated containers. When the mission ends the container is gone. This dramatically reduces blast radius.

What does 'infrastructure isolation' actually mean?โŒ„

Each agent runs in its own dedicated container (or compute unit). The control plane never sees your keys or long-term credentials. Secrets are injected only for that mission. Network, filesystem, and process boundaries are enforced by the infrastructure, not just code permissions.

Do agents keep running after they finish?โŒ„

No. By default agents are ephemeral. They have a TTL. Once the mission completes or the time limit is reached, the agent stands down. State can be snapshotted so a future mission can resume exactly where it left off.

Can I run RAID agents without any cloud?โŒ„

Yes. The system is local-first. You can run missions completely offline using your local Docker or container runtime. Cloudflare and other strategies are optional adapters.

How do I control what tools and data an agent can access?โŒ„

Everything is declared in the recipe YAML: allowed tools, secrets by name, policy rules, and TTL. Enforcement happens at the SDK level before any tool is invoked. You can audit exactly what was permitted for every mission.

REAL TEAMS

What users say

  • โ€œFinally an agent system designed by security people first.โ€

    Security Lead

    Series B SaaS

  • โ€œOne YAML file is now one governed capability. Huge shift.โ€

    Platform Engineer

    Fintech

  • โ€œResume works. Picks up hours later exactly where it stopped.โ€

    Head of AI

    AI Infrastructure

  • โ€œThe isolation and portability are what we actually needed.โ€

    CTO

    Enterprise

PROFESSIONAL SERVICES

We help teams ship agents that know when to leave.

The core is free and open. We also build recipes, set up isolation, and run production missions.

eliran@webo-tech.com