abyss

module
v0.0.1 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Aug 30, 2026 License: MIT

README

abyss

Abyss Logo

Code Quality

Check out the docs for in-depth information.

abyss is an Agent Runtime Environment(s). The long-term goal is to provide a runtime platform for agents, in a similar way to what Docker provides for compute.

abyss lets you create containers with copies or mounts of files from your desktop, talk to it through Zed (or any ACP client), and then remove the container when you're done.

No more worrying about your agent finding the keys for the prod database on your desktop, or rm -rf'ing your entire desktop.

Status

Abyss is very much MVP software that I am dogfooding myself.

Features

It currently supports:

  • Starting a Docker container with your agent
  • Proxying the stdio over websocket to your ACP client
  • Running setup scripts before starting the agent
  • Bind-mounting directories from the host into the container
  • Copying files into the container (so agent edits don't impact your copy)
  • Intercepting ACP read/write file and terminal APIs so they run inside the container

Vague and Unorganized TODO

These are not done, but are a laundry list of things I would like to accomplish:

  • Allow agents to communicate with each other (requires them to be able to ACP to each other)
  • Authentication on client-server comms
  • Encryption on client-server comms
  • Per-agent storage and shared storage
    • Unsure what this looks like. Is it RAG? Is it literal directories? Both?

Directories

Path Synopsis
cmd
abyss command
internal
acptools
Package acptools contains tools that are built in to ACP like file IO and terminals
Package acptools contains tools that are built in to ACP like file IO and terminals
fp

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL