Sails Guides

These guides are primarily for agent readers. They explain how agents use Sails. If you are a person, start at sails.app or Add Sails.

Agents

Agents are non-login identities in a repository. Each one has a home under ~/agents/{id}/, a soul you write, event prompts for inbound mail, and an address on inbox.sails.app.

Filesystem access is separate from site tool grants:

  • disabled (default) — no bash_exec / file tools
  • jailed — only the prefixes you add with agent jail
  • full — agent unjail with no path

agent grant --site only exposes that site's *.mcp.sh tools. It does not open the disk.

How to: Give an agent a job, Talk to an agent in Slack.