How itsjustayush/beton-cli works
BETON is a local-first command-line layer for everyday computer actions. Users invoke the Python CLI, which dispatches commands such as open, search, note, timer, and system control to focused domain modules; results are rendered in the terminal. Configuration and notes remain local, while opening targets delegates to platform adapters and search constructs a URL before the CLI opens it. The README documents additional capabilities whose handlers were not fully excerpted, so those links are shown as unverified. The npm runtime wrapper is included as a documented alternate entry point.
Main entry points: cli.py Command dispatcher · config.py Settings service · notes.py Notes service · base.py Platform adapter
Components 17
Command entry
- Command dispatcher
src/beton/cli.py - npm runtime wrapper
npm-package/bin/beton.js
Local actions
- Search URL builder
src/beton/search.py - Target resolver
src/beton/resolver.py - Notes service
src/beton/storage/notes.py - Countdown timer
src/beton/timer.py - System controls
src/beton/system.py - Upgrade service
src/beton/upgrade.py - Terminal renderer
src/beton/output.py
Platform services
- Platform adapter
src/beton/platform/base.py - Adapter selection
src/beton/platform/__init__.py
Local state
- Settings service
src/beton/config.py - Local settings file
src/beton/config.py - Markdown notes
src/beton/storage/notes.py
Other components
- CLI user
- Host operating system
- Web browser
Connections 19
- CLI user → Command dispatcher: runs commands
README.md - npm runtime wrapper → Command dispatcher: launches runtime
README.md - Command dispatcher → Search URL builder: builds search URL
src/beton/cli.py - Command dispatcher → Target resolver: resolves target
src/beton/cli.py - Command dispatcher → Adapter selection: gets adapter
src/beton/cli.py - Command dispatcher → Notes service: handles note commands
src/beton/cli.py - Command dispatcher → Countdown timer: runs countdown
src/beton/cli.py - Command dispatcher → System controls: handles system actions
src/beton/cli.py - Command dispatcher → Upgrade service: requests upgrade
src/beton/cli.py - Command dispatcher → Settings service: manages settings
src/beton/cli.py - Command dispatcher → Terminal renderer: renders results
src/beton/cli.py - Search URL builder → Command dispatcher: returns URL
src/beton/cli.py - Target resolver → Settings service: reads aliases
src/beton/resolver.py - Adapter selection → Platform adapter: selects implementation
src/beton/platform/__init__.py - Platform adapter → Host operating system: launches targets
src/beton/platform/base.py - Platform adapter → Web browser: opens URLs
src/beton/platform/base.py - Notes service → Settings service: gets note path
src/beton/storage/notes.py - Notes service → Markdown notes: reads and appends
src/beton/storage/notes.py - Settings service → Local settings file: reads and writes
src/beton/config.py