Skip to content

Tools Creative Docs About

Menu

Tools
Creative
Docs
About

Podbot

Runs AI coding agents inside isolated Podman containers. Credentials and the container socket stay with the trusted host side.

Introduction

Installation

Quick start

Command-line interface (CLI)

Global options
Subcommands

Configuration

Configuration file
Private key file requirements
Credential validation errors
Installation token acquisition
Environment variables
Container engine socket
TCP endpoint support
Supported TCP endpoint formats
Configuration examples
TCP-specific troubleshooting
Engine health check
Health check behaviour
Possible error messages
Connection error troubleshooting
Possible connection errors
Common permission scenarios
Sandbox configuration
Container creation behaviour
Credential injection behaviour

Security model

Error handling

Library API

Available API items
Return type
Example usage
Git identity configuration
Repository cloning
Library embedding
Experimental API
`run_agent`
`run_token_daemon`

Development

Running tests
Running lints
Checking formatting
Running all checks

Source

Source material

Contents

Introduction
- Introduction
Installation
- Installation
Quick start
- Quick start
Command-line interface (CLI)
Configuration
Security model
- Security model
Error handling
- Error handling
Library API
Development

Quick start

Updated Jul 27, 2026

Run an AI agent against a GitHub repository:

podbot run --repo owner/name --branch feature-branch

df12 Productions

Serious systems, playful worlds. We ship tools that cut build times and stories that map the human edge of complex networks.

OSS & Licences

Limela — licence
Netsuke — licence
mxd — licence
Episodic — licence

Stay in touch

[email protected]
GitHub
Bluesky

Built for curious builders and storytellers everywhere. © 2026 df12 Productions.