beaconctl CLI Tool Landing Page is Live!

The beaconctl command-line tool now has a dedicated project page.

beaconctl is the CLI interface for beacond, complementing the daemon and the beaconc library. It provides command-line access to all signal operations for manual control, scripting, and automation.

What beaconctl Provides

beaconctl is a self-contained binary that exposes beacond operations via command-line interface:

# Activate a signal
obscurity-beaconctl activate warning

# Monitor events
obscurity-beaconctl monitor

# Query signal status
obscurity-beaconctl get-info warning

The tool supports interactive use and can be integrated into shell scripts, deployment pipelines, or system startup sequences.

Implementation

The tool is built in Rust using the beaconc client library. It has no runtime dependencies and follows Unix conventions for exit codes and command structure.

All signal operations are implemented: activation, deactivation, monitoring, and querying. The tool supports connection to session bus, system bus, or custom DBus addresses.

Use Cases

The tool is useful for:

• Development and debugging of daemon integrations
• System automation scripts
• Manual signal control via terminal
• CI/CD pipelines and deployment automation
• Integration testing

Documentation

Visit the beaconctl project page for usage examples. Complete documentation is available in the repository.