Hurricane Sentinel in Plain English v2
This is the stored snapshot for the approved document version. The diff below shows what changed from the previous version.
Document snapshot
Hurricane Sentinel in Plain English
Summary
Sentinel is a safe place to run AI agents on your own computer. An agent is an AI that doesn't just chat — it takes actions: reading files, running commands, calling out to the network. Sentinel lets it do useful work while keeping it on a tight, enforced leash and keeping a human in charge of anything risky.
Just talk to it
You drive Sentinel from a clean little chat window in your terminal — or from a web
console in your browser, whichever you like. You type what you want; the agent works on
it and shows you, step by step, what it's doing — which AI it's asking, which tools it's
using, which teammates it's handing work to — and types out its answer at the end. When
it wants to do something you've marked as risky, it stops and asks you right there: yes
or no. In the terminal, start a line with a slash for commands (like switching agents or
picking a different AI model), with an @ to hand a job to a particular specialist, or
with a $ to browse the skills you can give an agent. The web console gives you the same
chat plus simple pages to set up your agents, teams, tools, models, and the guardrails —
all from the browser.
The three guards, working together
Sentinel is the conductor for the other two Hurricane tools:
- Muzzle sits in front of the AI model and checks everything going in and coming back out.
- Leash gives the agent its own user account on the machine and lets the operating system decide what it can touch, reach, and run.
- Sentinel runs the agent inside both of those guards, and adds the missing piece: a human approval step.
Because the agent runs as a real, leashed user account, the limits aren't a promise the AI makes — they're enforced by the computer itself.
Stop and ask a human
This is the part that makes Sentinel different. You decide which actions are fine to do automatically, which are flat-out forbidden, and which should stop and ask. When the agent reaches for a "stop and ask" action, Sentinel freezes the task right there, saves its place, and waits. Later you look at what it wants to do and say yes or no. If you say yes, it picks up exactly where it left off and carries on. If you say no, it's told no and keeps working around it. Nothing risky happens without a person's say-so.
Never loses its place
Every task is saved as it goes. It can pause for an approval for as long as it needs and resume later from the exact same spot — nothing is lost, and you always have a record of what happened.
A team of specialists
You don't run one all-purpose AI — you build a small team. Each agent has its own personality, its own know-how (skills), and even its own AI model. One of them is the manager: when you give it a job, it picks the right specialist from your team and hands the task off, or — if nobody on the team fits — it creates a temporary helper just for that job. You can keep a good temporary helper around for next time, throw it away, or have Sentinel ask you. Every hand-off still goes through the same "stop and ask" approval, and each helper is held to only the abilities you've given it.
You can also group agents into a proper team with a leader. Hand the whole team a job and the leader breaks it down, parcels the pieces out to its members, lets them work in parallel, and pulls their answers back together for you. Each member works in its own sealed-off space and can't peek into another team's files — so a big job gets done by many hands without anyone stepping on anyone else.
Give it your own tools
Built-in tools not enough? Hand Sentinel a Python file of your own. It reads the file to see what's inside — without ever running it — and shows you the functions it found; you tick the ones you want to become tools, and from then on your agents can use them, still behind the same "stop and ask" approval. If your tool needs extra software to run, Sentinel spots that and installs it for you with one click. Your code only ever runs in the same locked-down, leashed space as everything else — never with the keys to the whole machine.
Hand your whole team to someone else
Built a team you love? You can pack it up into a single file — the agents, their skills, their tools, your instructions, even the Python tools you added — and send it to someone else. They drop that file into their own Sentinel and get the exact same working team, minus your private keys (they add their own). It's like giving a friend a fully set-up marketing department in one download. Passwords and API keys never travel in the package.
Local or big-name AIs, your choice
Run everything on free models on your own machine, or plug in a paid one like OpenAI when you want more horsepower — you add it once from the console. Either way, every request still passes through Muzzle on the way out, so private details and secrets get scrubbed before they ever reach an outside company. Your API keys are held in one guarded place and are never shown back to you or handed to the AI.
It remembers
Each agent keeps its own notebook. When it learns something worth keeping, it writes itself a note; later — even in a completely separate session — it can look that note back up and use it. The notebooks are private to each agent by default, but you can let a few agents share one. So your specialists actually get better over time instead of starting from scratch every run. And because a long task can fill up an AI's short-term memory, Sentinel quietly tidies up as it goes — summarizing the older back-and-forth while keeping the important recent bits — so nothing important gets lost and the agent never runs out of room.
Made to work with small AIs
You shouldn't need an enormous, expensive model to get reliable results. Sentinel does a lot of quiet work so even small models running on your own machine behave well: it tells the model clearly how to use its tools, understands a tool request even when the model phrases it sloppily, fixes up small mistakes and asks the model to try again, and makes sure a specialist always gets the full original request — so a manager's terse hand-off never drops the details.
Save a recipe and reuse it
For jobs you do over and over, you can save a workflow — a little recipe of steps. Step one might be "have the researcher gather the facts," step two "have the writer turn them into a summary." Sentinel runs the steps in order and automatically hands each step's result to the next, so the writer gets exactly what the researcher found. You give it a starting input, run it by name, and it does the whole sequence — and every step still runs under the same guards and approvals as anything else.
Where it's at
Sentinel is in the lab, but wide and running on real machines. The whole thing works end to end on Linux: agents running under the guards with real operating-system enforcement actively blocking off-limits files, pausing for approval and resuming, managers and full teams delegating to persistent specialists, agents that remember across sessions, saved multi-step workflows, scheduled jobs — driven from either a clean chat window or a browser console. Since then it's grown: the web console is built, teams, paid AI providers alongside the free local ones, your own uploaded Python tools, and packing up a whole team to hand to someone else. The whole platform has been through a security review and hardened against the problems that review turned up. It runs on Linux only for now, and there's no public download just yet.
Diff from previous
--- PLAINENGLISH@1 +++ PLAINENGLISH@2 @@ -9,14 +9,16 @@ ## Just talk to it -You drive Sentinel from a clean little chat window in your terminal. You type what you -want; the agent works on it and shows you, step by step, what it's doing — which AI it's -asking, which tools it's using — and types out its answer at the end. When it wants to -do something you've marked as risky, it stops and asks you right there: yes or no. Start -a line with a slash for commands (like switching agents or picking a different AI -model), with an `@` to hand a job to a particular specialist, or with a `$` to browse -the skills you can give an agent — and a little menu pops up to help you. Your past -messages are remembered, so the up arrow brings them back. +You drive Sentinel from a clean little chat window in your terminal — or from a web +console in your browser, whichever you like. You type what you want; the agent works on +it and shows you, step by step, what it's doing — which AI it's asking, which tools it's +using, which teammates it's handing work to — and types out its answer at the end. When +it wants to do something you've marked as risky, it stops and asks you right there: yes +or no. In the terminal, start a line with a slash for commands (like switching agents or +picking a different AI model), with an `@` to hand a job to a particular specialist, or +with a `$` to browse the skills you can give an agent. The web console gives you the same +chat plus simple pages to set up your agents, teams, tools, models, and the guardrails — +all from the browser. ## The three guards, working together @@ -57,6 +59,38 @@ or have Sentinel ask you. Every hand-off still goes through the same "stop and ask" approval, and each helper is held to only the abilities you've given it. +You can also group agents into a proper **team** with a leader. Hand the whole team a +job and the leader breaks it down, parcels the pieces out to its members, lets them work +in parallel, and pulls their answers back together for you. Each member works in its own +sealed-off space and can't peek into another team's files — so a big job gets done by +many hands without anyone stepping on anyone else. + +## Give it your own tools + +Built-in tools not enough? Hand Sentinel a Python file of your own. It reads the file to +see what's inside — without ever running it — and shows you the functions it found; you +tick the ones you want to become tools, and from then on your agents can use them, still +behind the same "stop and ask" approval. If your tool needs extra software to run, +Sentinel spots that and installs it for you with one click. Your code only ever runs in +the same locked-down, leashed space as everything else — never with the keys to the +whole machine. + +## Hand your whole team to someone else + +Built a team you love? You can pack it up into a single file — the agents, their skills, +their tools, your instructions, even the Python tools you added — and send it to someone +else. They drop that file into their own Sentinel and get the exact same working team, +minus your private keys (they add their own). It's like giving a friend a fully set-up +marketing department in one download. Passwords and API keys never travel in the package. + +## Local or big-name AIs, your choice + +Run everything on free models on your own machine, or plug in a paid one like OpenAI when +you want more horsepower — you add it once from the console. Either way, every request +still passes through Muzzle on the way out, so private details and secrets get scrubbed +before they ever reach an outside company. Your API keys are held in one guarded place +and are never shown back to you or handed to the AI. + ## It remembers Each agent keeps its own notebook. When it learns something worth keeping, it writes @@ -88,11 +122,13 @@ ## Where it's at -Sentinel is **in the lab**. The heart of it — running an agent under the guards, pausing -for approval and resuming, a manager agent delegating to a team of persistent -specialists, agents that remember things across sessions, a clean chat window to drive -it all, and saved multi-step workflows — is built and has been tested working end to end -on Linux, including with the operating-system enforcement switched on and actively -blocking the agent from off-limits files, and producing correct results on local models. -The remaining piece — a local web dashboard — is still being built. It runs on Linux -only for now, and there's no public download yet. +Sentinel is **in the lab, but wide and running on real machines.** The whole thing works +end to end on Linux: agents running under the guards with real operating-system +enforcement actively blocking off-limits files, pausing for approval and resuming, +managers and full teams delegating to persistent specialists, agents that remember across +sessions, saved multi-step workflows, scheduled jobs — driven from either a clean chat +window or a browser console. Since then it's grown: the web console is built, teams, +paid AI providers alongside the free local ones, your own uploaded Python tools, and +packing up a whole team to hand to someone else. The whole platform has been through a +security review and hardened against the problems that review turned up. It runs on Linux +only for now, and there's no public download just yet.