acsetra — the Runner CLI
A thin client for building and running hosted Runner apps from your terminal.
It holds no framework logic: every authoring command serializes to {op, args}
and is POSTed to the hosted API, where validation, reserved-code guards, and
doctor compiles all run server-side. You get the grammar of the framework, not
its implementation.
Install
pipx install acsetra # recommended (isolated)
# or: pip install acsetra
runner signin
Exposes three console scripts — runner (primary), acsetra (brand alias), and
r (continuity with ./r).
Quick start
runner signin # device-flow sign-in; caches a token
runner whoami
runner app create crm --label "CRM" # create an app scope in your workspace
runner set put crm contacts ada --json '{"role":"eng"}'
runner read contacts -S <workspace>.crm
runner doctor <workspace>.crm && runner compile <workspace>.crm
runner auth crm # gate the app behind home.acsetra.com sign-in
runner dev <workspace>.crm # open the app's hosted surface in your browser
runner open <workspace>.crm # reuse/create its paired Chrome tab
runner notify <workspace>.crm --title Ready
runner tabs
How it fits together
runner signinruns the OAuth device flow: it prints a URL + code, you approve in the browser, and the CLI caches a token at~/.config/acsetra/credentials(0600).runner docs pullwritesCLAUDE.md+.runner/docs/*— concise doctrine and a framework model for Claude Code. Exact grammar always comes fromrunner <group> <subverb> --help, so it cannot drift from the installed client.runner open,focus,notify, andtabsuse the paired Runner Chrome extension. CLI and ChatGPT MCP write the same short-lived browser intents.- The hosted DB is the source of truth. Local files are instructions and mirrors,
never runtime source.
runner checkoutproduces disposable working copies under.tmp/for grep and inspection;runner dev <app>just opens the live hosted surface in your browser.
Environment overrides
| Var | Meaning |
|---|---|
ACSETRA_API_BASE |
hosted API origin (default https://home.acsetra.com) |
ACSETRA_TOKEN |
bearer token (skips the cached credential) |
ACSETRA_WORKSPACE |
act in this workspace slug |
ACSETRA_SCOPE |
default app scope for -S-less commands |
Run runner help for the full verb list.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file acsetra-0.1.69.tar.gz.
File metadata
- Download URL: acsetra-0.1.69.tar.gz
- Upload date:
- Size: 193.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
f75c44ce6a5f9e68ecd471bb2697cb68748e110eacd9afa11c224976c85bae56
|
|
| MD5 |
2c32f85f3cc28e4f836ae204187afde4
|
|
| BLAKE2b-256 |
6b83a22ec279606dad3d322b9852ca6c7faa9eb844a14321b63095147efe503d
|
File details
Details for the file acsetra-0.1.69-py3-none-any.whl.
File metadata
- Download URL: acsetra-0.1.69-py3-none-any.whl
- Upload date:
- Size: 27.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
fe738ecc4e4cf856e672cefd0c1812a0b50e6569a906ce6202b3c4c06b5677bd
|
|
| MD5 |
a87e4d8de2793efc8d9b796b3b14dc04
|
|
| BLAKE2b-256 |
0197acfee46cc25b129a4d964df767c5f8127965695c98808548803478233f06
|
