ghostbt 0.1.0

Ghost Build Tool - build and package GhostESP native SD apps

gbt — Ghost Build Tool

Build and package GhostESP native SD apps from the command line.

Install

pip install ghostbt

Requires Python 3.8+ and ESP-IDF (install via gbt setup).

Quick Start

# Set up ESP-IDF (one-time)
gbt setup

# Create a new app
gbt create my_app --name "My App"

# Build and package
gbt dist ./my_app --gapp

# Flash firmware to device
gbt firmware cardputer
gbt flash firmware --board cardputer --monitor

Commands

Command	Description
gbt create <id>	Scaffold a new native SD app
gbt build [dir]	Build app with ESP-IDF
gbt package [dir] --gapp	Package as folder or .gapp archive
gbt dist [dir] --gapp	Build + package in one step
gbt setup	Install/configure ESP-IDF toolchain
gbt boards	List available firmware board configs
gbt firmware <board>	Build GhostESP firmware
gbt flash firmware	Flash firmware to device
gbt flash app	Instructions for loading app via SD card
gbt monitor	Serial monitor
gbt ports	List serial ports

Requirements

• Python 3.8 or later
• ESP-IDF (auto-installed by gbt setup if missing)
• Git (for gbt setup)

Links

• GhostESP GitHub
• Full documentation