Skip to content
hop.top/aps

Getting Started

Install

Section titled “Install”
Terminal window
# Build from source
git clone https://github.com/hop-top/aps.git
cd aps
make build

Or download a release binary from GitHub Releases.

Create a profile

Section titled “Create a profile”
Terminal window
aps profile new myagent --display-name "My AI Agent" --email "agent@example.com"

Choose an isolation level

Section titled “Choose an isolation level”
Terminal window
# Process isolation (default, fastest)
aps profile new myagent


# Platform isolation — macOS/Linux user-level sandbox
aps profile new myagent --isolation-level platform


# Container isolation — strongest, requires Docker
aps profile new myagent --isolation-level container

Run a command under a profile

Section titled “Run a command under a profile”
Terminal window
# Run any command isolated under the profile
aps myagent -- echo "Hello from agent!"


# Git with profile's own config
aps myagent -- git status


# Interactive shell
aps myagent

Generate documentation

Section titled “Generate documentation”
Terminal window
aps docs

Docs will be written to ~/.agents/docs/.