Skip to content
ToxicPinePublic

About

No description, website, or topics provided.

Resources

Stars

13 stars

Watchers

0 watching

Forks

Repository files navigation

Ambi(en)t

License: GPL v3 npm @cardelli/ambit GitHub stars Built with Nix Stability: Beta

A toolkit for hosting apps in the cloud so that only you — and the AI agents you work with — can reach them.

When you put something on the internet, you often have to build login pages, configure firewalls, and worry about bots or strangers stumbling across it. These tools skip all of that. Your apps live in the cloud but are completely invisible to the public internet: everything — your apps, your agents, your databases — live behind the same virtual private network (VPN), and only the devices that you've added to the network can access them.

NOTE: This relies on Tailscale, you should look into Tailscale first.

Example: Cloud IDE (OpenCode) in 4 Steps

This is an IDE for Claude Code, Codex, etc, that you can access from desktop or mobile, with seamless handoff.

  1. Install Tailscale.
  2. Create a Network:
    npx @cardelli/ambit create lab
  3. Follow the Instructions to link your cloud provider.
  4. Deploy:
    npx @cardelli/ambit deploy my-ide.lab --template ToxicPine/ambit-templates/opencode

Open http://my-ide.lab on any device connected to your network (via Tailscale). You now have a persistent OpenCode workspace running in the cloud — accessible from your laptop, tablet, or phone, completely invisible to the public internet, and available only to you.

Projects

Ambit is the core tool. It deploys your apps — databases, dashboards, internal tools, anything packaged as a Docker image — onto a private cloud network that only your devices can reach (via Tailscale VPN). Each app gets a clean, human-readable address like http://my-app.lab, and you access it the same way you'd access anything on your home network. No login page needed, because access is controlled at the network level: if your device is on the network, the app is there; if it isn't, the app simply doesn't exist from its perspective.

→ Read the Ambit docs


The ambit-templates repo has ready-to-deploy examples for common setups.

Template Description
wetty A cloud devshell — Nix-based environment with a web terminal, persistent home directory, passwordless sudo, and auto start/stop.
opencode A private OpenCode web workspace — Nix-based environment with persistent home and auto start/stop.
chromatic A headless Chrome instance exposing the Chrome DevTools Protocol — for AI agents or scripts that need to drive a browser on your private network.
openclaw A self-hosted OpenClaw instance — a personal AI assistant you can talk to from WhatsApp, Telegram, Discord, and other chat apps.

Installation

Ambit is available on npm:

npx @cardelli/ambit --help

With Nix:

nix shell 'git+https://github.com/ToxicPine/ambit.git?submodules=1#default' -c ambit --help

Use the Git URL so Nix fetches the pinned submodules, including the bundled skills. The github:ToxicPine/ambit archive fetch omits submodules.

Agent Skills

HIGHLY RECOMMENDED: Install the skill to help your AI coding agent discover Ambit's CLI guide. Works with Claude Code, Cursor, Windsurf, and other AI coding agents:

npx skills add ToxicPine/ambit --skill ambit

The installed skill directs the agent to the guide shipped with its CLI version:

npx @cardelli/ambit skills list
npx @cardelli/ambit skills get core
npx @cardelli/ambit skills list --json

The stub lives at skills/ambit/SKILL.md. The CLI serves registered guides from the pinned ambit-skills/skills/ submodule.

When building or running from a checkout, initialize the skills submodule:

git submodule update --init ambit-skills

Quick Usage

Set Up a Private Network and Deploy an App:

npx @cardelli/ambit create lab
npx @cardelli/ambit deploy my-app.lab
# → http://my-app.lab, visible only to your devices

npx @cardelli/ambit share lab group:team alice@example.com
# → grants your whole team access to the lab network

Deploy a headless browser from a template:

npx @cardelli/ambit deploy my-browser.lab --template ToxicPine/ambit-templates/chromatic
# → headless Chrome on your private network, reachable via CDP at my-browser.lab:9222

About

No description, website, or topics provided.

Resources

Stars

13 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages