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                              # you + every org you can reach, with access (owner/edit/view)
runner app create <org>.crm --label "CRM"  # create an app scope in THAT org (any org you can edit)
runner set put <org>.crm contacts ada --json '{"role":"eng"}'
runner read contacts -S <org>.crm
runner doctor <org>.crm && runner compile <org>.crm
runner auth <org>.crm                      # gate the app behind home.acsetra.com sign-in
runner dev <org>.crm                       # open the app's hosted surface in your browser
runner open <org>.crm                      # reuse/create its paired Chrome tab
runner notify <org>.crm --title Ready
runner tabs

Every command names its target by full scope path <org>.<app> — the first segment is the org, and that is what routes the command. Nothing is pinned per project: you may read every org you belong to and author in any org where your share access is edit (granted in Runner Command → Share). A bare leaf (crm) only resolves against the token's home org — runner use <slug> changes that default, but full paths never need it.

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 home org slug for bare-leaf scopes (full <org>.<app> paths route themselves)
ACSETRA_SCOPE default app scope for -S-less commands

Run runner help for the full verb list.

Project links

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.2.1)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for lukecooper from gravatar.com lukecooper

Credits

Author: Acsetra

License

MIT

Requires

Python >=3.9

Tags

acsetra agent cli low-code runner

Report project as malware

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.77.tar.gz (194.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.77-py3-none-any.whl (28.3 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: acsetra-0.1.77.tar.gz
  • Upload date:
  • Size: 194.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.77.tar.gz
Algorithm Hash digest
SHA256 94580b493045a864e355716e28de22c57ced136e5f74e8bd0d741a00ac344a14
MD5 3878c7f135c06012897a19ee9ec8d7bd
BLAKE2b-256 e28953101f130634e54f0ce02ab5c5e50c33035b93550d0b4329973bf61ab688

See more details on using hashes here.

File details

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

File metadata

  • Download URL: acsetra-0.1.77-py3-none-any.whl
  • Upload date:
  • Size: 28.3 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.77-py3-none-any.whl
Algorithm Hash digest
SHA256 307e5d06d07d52088717d5872220e2ed7d1c6e74c310019d7aa7d06a729134e6
MD5 431ee7b0274b58b3f4fc682939aae6dc
BLAKE2b-256 557297566b7391745ac9ebcf1908d5aa5b3c0ca3e50cf309b85c04802d3c0f9f

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

This release

0.1.77 This release

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

0.1.61

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