The Kernel
The Kernel is Wisp's local security gatekeeper. It's part of the Wisp agent on your machine, and sits between the LLM on one side and your filesystem and the encrypted database on the other, to enforce hard boundaries on what any tool call can do.
What the Kernel checks
Before anything executes, the Kernel checks:
Project boundary
- Path canonicalization: resolves
../.., symlinks and relative paths to their absolute form, to prevent directory traversal attacks. - Symlink handling: a symbolic link is judged by where it leads, so a link inside the project cannot carry a call out of it unchecked.
- Absolute path resolution: absolute paths aren't rejected outright. The Kernel
resolves them and always refuses those that lead into sensitive places (for example
/etc/passwd,~/.ssh/or a.envfile) or into~/.wisp. A path outside the project is refused while the sandbox is on; with it off, the call waits for your approval, whatever your Rules say. - Bash command check: with the sandbox on, a bash command that names
../,~/or an absolute path outside the project is refused before it runs. What holds a command in after that,cd ..included, is the sandbox itself: it sees the project and read-only system folders, nothing else of yours.
Schema and permissions
- Validates every tool call against its JSON schema, so malformed arguments never reach your OS.
- Checks whether the requested operation is allowed: for example,
fs_write,fs_editandbash_runrequire your confirmation first (the confirmation gate), whilefs_readis scoped read-only.
A request, step by step
- You send a message.
- The Wisp agent plans which tools it needs to fulfill the request.
- The Kernel validates each tool call against its schema.
- The Kernel checks the call against your Rules.
- The confirmation gate fires for writes and destructive operations.
- Tools execute locally or through the Wisp Proxy. A tool resolves its paths as it starts and refuses the call if they lead out of bounds.
- The audit logger records what happened.
The Kernel is the universal stopgap. If an LLM hallucinates and tries to rm -rf ~ or read
your global password store, the Kernel kills that call before it ever spawns a process. It
is the component that lets you give an autonomous agent access to your machine without
trusting it with root-level access.