Portenv
Resume your work anywhere, and let your agents work in it for you.
Portenv — your portable workspace (short for portable environment) — is a native Mac app that gives each project an encrypted workspace that can be saved, moved between a Mac, developer-owned servers and Portenv Cloud, and opened safely to AI agents.
In the code, APIs and paths a workspace is called a box.
Status: early development (Phase 0, foundations). Nothing here is usable yet.
Repository
| Path | What it is |
|---|
apps/ | Mac app and iPhone companion (SwiftUI) |
core/ | Go: portenvd, portenv-runner, portenv-agent, the portenv CLI, box drivers, sync |
shims/containerization/ | Swift process implementing the box driver on Apple Containerization |
proto/ | gRPC protocols shared by the app, daemons, box agent and the hosted service |
images/ | Toolbox images |
docs/ | The plan (docs/PLAN.md), architecture decisions (docs/adr/), design mockups, milestone notes |
The control plane and gateway behind Portenv Cloud are developed separately.
Building
Requires Go 1.26 and, for the Swift parts, Xcode 26 on an Apple silicon Mac.
make build # build portenvd, portenv-runner, portenv-agent and portenv into bin/
make test # Go tests with the race detector
make lint # formatting, vet, golangci-lint, buf lint, workflow lint, SPDX headers
make proto # regenerate Go code from proto/
make check # everything CI runs that works on this machine
Developer tools (buf, protoc plugins, golangci-lint, actionlint, gitleaks) are pinned in the Makefile and installed into bin/ on first use.
Trademarks
Grok Bot, ChatGPT Dots and Meta Muse are trademarks of their respective owners. Portenv is not affiliated with or endorsed by them.
License
Apache License 2.0. See LICENSE and NOTICE.
