explaingit

abhayparolkar/zboy

Analysis updated 2026-05-18

6ShellAudience · developerComplexity · 4/5LicenseSetup · hard

TLDR

A local, sandboxed coding agent for Mac that keeps AI-driven file and shell access inside a disposable container instead of your host machine.

Mindmap

mindmap
  root((ZBoy))
    What it does
      Local coding agent
      Sandboxed execution
      No cloud AI needed
    Tech stack
      Apple container
      MLX inference
      Node based agent
    Use cases
      Safe local coding
      Rails development
      Remote chat control
    Audience
      Mac developers
      Privacy focused teams

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Run an AI coding agent on your Mac without exposing your host filesystem to it.

USE CASE 2

Work on Rails projects with a local model instead of a cloud AI service.

USE CASE 3

Control the coding agent remotely through Telegram, Slack, or Discord.

What is it built with?

ShellApple containerMLXNode.jsRails

How does it compare?

abhayparolkar/zboydmaynard51/ultima1-iosjerlinn/jerlin-weread
Stars666
LanguageShellShellShell
Setup difficultyhardmoderate
Complexity4/53/5
Audiencedevelopergeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1h+

Needs macOS 26 on Apple Silicon, Apple's container CLI, and a local MLX model server already running.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

In plain English

ZBoy sets up a coding assistant that runs entirely on your own Mac, without sending your code to a cloud AI service. It combines a local AI language model with a coding agent called pi, but keeps the two carefully separated for safety: the AI model itself runs directly on your Mac to use the machine's chip efficiently, while the coding agent that actually reads files and runs commands lives inside a disposable virtual machine, using Apple's container feature. This means if the AI decides to run something unexpected, it happens in a throwaway environment rather than directly on your work computer, and no developer tools like Node.js need to be installed on your actual Mac. The project was built with Ruby on Rails projects in mind, though the README states it can work with other kinds of projects too. Setup involves building the container image, finding the network address the container uses to reach your Mac, and running a script that mounts your project folder into the disposable environment. A separate script lets you open a plain shell inside the same sandboxed environment for manual poking around. There are a few safety and configuration details worth knowing. A built in extension can block or require confirmation before the agent touches sensitive files like SSH keys or credential files. The project also supports connecting the coding agent to messaging apps such as Telegram, WhatsApp, Slack, Discord, and Matrix, so you can send it instructions remotely from your phone. This requires a fairly specific setup: a recent Apple Silicon Mac running macOS 26, Apple's container command line tool, and a local model server already running. The README describes the project's current status as an early, hands on draft rather than a polished release, so some rough edges should be expected.

Copy-paste prompts

Prompt 1
Walk me through building and running the ZBoy container on my Mac.
Prompt 2
Explain how the protected-paths extension guards sensitive files like SSH keys.
Prompt 3
Help me set up the messenger bridge so I can message the agent from Telegram.
Prompt 4
Show me how to find the container bridge IP for models.json.

Frequently asked questions

What is zboy?

A local, sandboxed coding agent for Mac that keeps AI-driven file and shell access inside a disposable container instead of your host machine.

What language is zboy written in?

Mainly Shell. The stack also includes Shell, Apple container, MLX.

What license does zboy use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is zboy to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is zboy for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.