Skip to main content

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 signin runs 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 pull writes CLAUDE.md + .runner/docs/* — concise doctrine and a framework model for Claude Code. Exact grammar always comes from runner <group> <subverb> --help, so it cannot drift from the installed client.
  • runner open, focus, notify, and tabs use 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 checkout produces 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.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

acsetra-0.1.61.tar.gz (193.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

acsetra-0.1.61-py3-none-any.whl (27.1 kB view details)

Uploaded Python 3

File details

Details for the file acsetra-0.1.61.tar.gz.

File metadata

  • Download URL: acsetra-0.1.61.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

Hashes for acsetra-0.1.61.tar.gz
Algorithm Hash digest
SHA256 c2db8f808cb72980e51d794a64200534ce23347ff00b54e3fc9c79a56a5b83ad
MD5 f74274809a2ef5c1496a8caae957268f
BLAKE2b-256 f90281b9bb8a2c34294f90a2849c6103ab85eb1f7e8f883510f845aa402f0db0

See more details on using hashes here.

File details

Details for the file acsetra-0.1.61-py3-none-any.whl.

File metadata

  • Download URL: acsetra-0.1.61-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

Hashes for acsetra-0.1.61-py3-none-any.whl
Algorithm Hash digest
SHA256 9ce0f447d477f0d7c41096743e6431fe92ee4ddb873b17c1a2f4a32bcff80b31
MD5 36f7f7e2ef5b253fe512b0463f5b952a
BLAKE2b-256 1e0355becabeead2a420f970a802fd1858dc89eb6f06e42c1ddce7a833c6e991

See more details on using hashes here.

Release history Release notifications | RSS feed

0.2.1

2 files

0.2.0

2 files

0.1.99

2 files

0.1.98

2 files

0.1.97

2 files

0.1.96

2 files

0.1.95

2 files

0.1.94

2 files

0.1.93

2 files

0.1.92

2 files

0.1.91

2 files

0.1.90

2 files

0.1.89

2 files

0.1.88

2 files

0.1.87

2 files

0.1.86

2 files

0.1.85

2 files

0.1.84

2 files

0.1.83

2 files

0.1.82

2 files

0.1.81

2 files

0.1.80

2 files

0.1.79

2 files

0.1.78

2 files

0.1.77

2 files

0.1.76

2 files

0.1.75

2 files

0.1.74

2 files

0.1.73

2 files

0.1.72

2 files

0.1.71

2 files

0.1.70

2 files

0.1.69

2 files

0.1.68

2 files

0.1.67

2 files

0.1.66

2 files

0.1.65

2 files

0.1.64

2 files

0.1.63

2 files

0.1.62

2 files

This release

0.1.61 This release

2 files

0.1.60

2 files

0.1.59

2 files

0.1.58

2 files

0.1.57

2 files

0.1.56

2 files

0.1.55

2 files

0.1.54

2 files

0.1.53

2 files

0.1.52

2 files

0.1.51

2 files

0.1.50

2 files

0.1.48

2 files

0.1.47

2 files

0.1.46

2 files

0.1.45

2 files

0.1.44

2 files

0.1.43

2 files

0.1.42

2 files

0.1.39

2 files

0.1.38

2 files

0.1.37

2 files

0.1.35

2 files

0.1.34

2 files

0.1.31

2 files

0.1.29

2 files

0.1.26

2 files

0.1.25

2 files

0.1.24

2 files

0.1.19

2 files

0.1.16

2 files

0.1.15

2 files

0.1.14

2 files

0.1.12

2 files

0.1.11

2 files

0.1.10

2 files

0.1.7

2 files

0.1.6

2 files

0.1.5

2 files

0.1.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page