# What Workspace does · Loa Workspace

An agent reaches the repository only through these. Each one does one thing, says what it did, and answers in the same shape every time. The two that reach a remote, git_fetch and git_push, are there only when you set one up.

## The tools

### Look

- `workspace`: What this workspace is, and what a call may do. Its root, its repositories, its secrets by name and never by value, and how a command is confined.
- `read`: A text file, as numbered lines. In place of cat, head and tail.
- `stat`: What is at a path, without reading it.
- `list`: What is under a directory, to a depth. In place of ls and tree.
- `glob`: Files by the shape of their path.
- `grep`: Text files that match a regular expression. In place of grep and rg.
- `outline`: The definitions in a file or under a directory.

### Change

- `edit`: Replaces text in a file.
- `write`: Creates a file, or overwrites one.
- `patch`: Changes several files in one call that lands whole or not at all.
- `change`: Writes, deletes and moves files, each held to its version.
- `file_snapshots`: The snapshots kept of the files, newest first.
- `restore_files`: Puts the files back as they were before a command. Files the snapshot holds are written back, and files made since are removed.

### Run

- `shell`: Runs one command, confined to the workspace. Each call stands alone, and nothing is interactive. Git there can read the repository but not change it: commits, fetches and pushes go through the git tools.
- `process_list`: The processes running, newest first, with the ports they listen on.
- `process_output`: What a process printed, running or ended.
- `process_wait`: Waits for a process to exit, listen or print, without polling.
- `process_kill`: Ends a process and everything it started.

### Git

- `git_status`: Where the repository stands.
- `git_diff`: What changed, as a unified diff.
- `git_log`: The commits on the branch, newest first.
- `git_commit`: Commits to the branch the tree is on. The commit carries the workspace's author, whatever git configuration the repository has.
- `git_fetch`: Fetches the remote's branches, and moves nothing of yours.
- `git_push`: Pushes this branch to the branch of the same name. To the one remote the owner named, with a credential the server holds and the model never sees. No other branch, no tag, no delete.

## What it does not do

- It holds no agent and no model. Bring your own, like Claude Code, or any MCP client. (README.md)
- It works in one directory and pushes to one remote, both named by you. (docs/getting-started.md §3)
- A push never forces, and makes no tag and no delete. (toolset/gated.go)
- It won't start where it can't confine commands, unless you turn the sandbox off with sandbox: none. Then it refuses a git token. (docs/getting-started.md §6; docs/serve.md; daemon/credential.go)
- On a Mac, it runs in your login session and stops when you log out. (docs/getting-started.md §6)
- Experimental. It also runs in Amazon Bedrock AgentCore Runtime, one microVM per session, with the same sandbox inside it. The container recipe (arm64) is in deploy/agentcore. For now it sets up one repository when the container starts; setting up a session from its first call isn't built yet. (deploy/agentcore/README.md; docs/serve.md, "Platform agentcore"; docs/notes/2026-11-20-report-agentcore-experiment.md)

- [Get started](https://workspace.getloa.app/en/../start/): From nothing to a pushed change.
- [Watch a real run](https://workspace.getloa.app/en/../#run): Eight calls, fifteen seconds, two bugs fixed.
- [Inside the box](https://workspace.getloa.app/en/../#box): The sandbox, the token, the network, the log and the tests.

Loa Workspace v0.11.0. Licensed under the Functional Source License 1.1, with MIT as its future licence (FSL-1.1-MIT): each release becomes MIT two years after it comes out. Coming soon: the download opens when the repository goes public.
