silicon-cli 1.0.1

Silicon CLI — create, run, and manage your silicon instances.

silicon-manager

This is the single source for the installable silicon command. The PyPI package is still named silicon-cli, but the code lives here in silicon-manager so it is not confused with a runnable Silicon instance tree.

The command manages silicon instances on a machine: create them from the silicon-stemcell base, start/stop them under an auto-restart watchdog, stream logs, and back them up to Glass. It reads the same ~/.silicon/registry.json, so existing installs carry over unchanged.

Install

pip install silicon-cli

(Zero runtime dependencies — stdlib only.)

Commands

silicon                      Show status or list instances
silicon new [dir]            Create a new Silicon (hydrate from stemcell)
silicon new .                Hydrate the current folder into a runnable silicon
silicon start <target>       Start silicon(s). target = name, index, 1,2,4, or all
silicon stop [--full] <target>  Stop silicon(s) (--full also stops the glass agent)
silicon restart <target>     Restart silicon(s)
silicon agent <start|stop|status> [name]   Manage the per-silicon glass agent
silicon status [name]        Show instance status
silicon browser [name]       Open a headed browser for login
silicon debug [name]         Tail a running instance's logs
silicon attach [path]        Register an existing silicon directory
silicon pull <username>      Pull a silicon from Glass into a new folder
silicon push [name] [now|stop]   Hourly backups to Glass (now = one-shot, stop = end loop)
silicon backup [name] [now|stop] Alias for silicon push
silicon update <target>      Update silicon(s) from the latest stemcell
silicon list                 List all instances
silicon script update        Update this CLI itself
silicon help                 Show help

Configuration (env vars)

Var	Default	Purpose
SILICON_HOME	~/.silicon	registry + CLI state
GLASS_SERVER_URL	https://glass.unlikefraction.com	Glass sync server (pull/push)
SILICON_STEMCELL_REPO	unlikefraction/silicon-stemcell	base for new
SILICON_GLASS_CLI_REPO	unlikefraction/glass	glass backup CLI
SILICON_PYTHON	python3	interpreter used to run a silicon's main.py

Backups

silicon push <name> now and silicon backup <name> now use the .backupsilicon manifest when the instance has one. The CLI archives those paths and uploads them to Glass via /api/v1/silicon-backups/ with the instance's .glass.json API key. If no manifest exists, the command falls back to the legacy glass push snapshot flow.

How it differs from the bash version

• Pure Python package with a silicon console entry point (installed in an isolated venv), instead of a single bash script.
• The auto-restart watchdog runs as silicon _watchdog (a detached supervisor process) rather than a backgrounded bash function — same crash-loop detection, .silicon.stop sentinel, and .silicon.pid/.silicon.log behavior.
• silicon script update reinstalls the package via pip from its recorded source.
• Everything (server, stemcell repo) is env-overridable.