Every script gets a complete spec.md sectionized like SPEC.md (python/src/<name>/spec.md, <name>.spec.md for shell scripts). Change order becomes spec -> tests -> code. Specs added for gpgtools, hello, hello_bash; CHANGELOG under Unreleased. Generated by Mistral Vibe. Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
daedalus (template)
Starter repository for daedalus: one CLI, many small scripts, each with tests.
daedalus <name> [args...] # run a script
daedalus <category> [category...] # list scripts in the categories (AND)
daedalus --list # list everything
Install, usage, and development · SPEC (how the repo is maintained) · CHANGELOG
Available scripts
| Script | Type | Categories | What it does |
|---|---|---|---|
gpgtools |
Python | gpg | YubiKey GPG/SSH helpers: initialize_yubikey (fresh machine, steps 1-4) and send_pubkey (resolve key, verify possession, append to a server) |
hello |
Python | test | Prints a hello line and the daedalus version |
hello_bash |
Bash | test | Sample bash script through the shared help() interface |
Run the sample script:
daedalus hello # hello from daedalus 0.4.0
daedalus hello_bash me # hello, me (from daedalus bash)
daedalus hello_bash -h # usage from hello_bash's help()
daedalus test hello # same, through the category prefix
daedalus test # list the scripts in the 'test' category
daedalus --list prints the version, a script / type / categories
table, and each description wrapped under each row.
gpgtools
initialize_yubikey runs the fresh-machine flow for YubiKey-backed
GPG and SSH (steps 1-4 of the wiki guide): install gnupg when missing,
check the card, fetch the public key from the card's URL field, and
write the gpg-agent SSH config. Deriving and deploying the SSH key
(steps 5-7) is server-specific and stays manual for now.
daedalus gpgtools # overview of the subcommands
daedalus gpgtools initialize_yubikey # prepare this machine
daedalus gpgtools initialize_yubikey --dry-run # print the plan only
| Argument | Default | Meaning |
|---|---|---|
--dry-run |
off | Print the plan, write nothing |
--gnupg-home DIR |
GNUPGHOME or ~/.gnupg |
Which GnuPG home to configure |
Exit codes: 0 ready, 2 package install failed, 3 gpg missing and
no known package manager, 4 no card found, 5 public-key fetch did
not pair the keyring, 6 keyring unpaired and the card carries no URL.
send_pubkey covers guide steps 5-6 for one server: resolve the SSH
public key from one of four sources, prove possession of the private
half with a challenge signature (the YubiKey itself signs; PIN prompts
go to the user), then append the line to the target's
authorized_keys — idempotent, fingerprint-checked against stores,
and nothing is sent when verification fails.
daedalus gpgtools send_pubkey --yubikey you@server
daedalus gpgtools send_pubkey --fingerprint <FP> you@server
daedalus gpgtools send_pubkey --url https://keys.openpgp.org/vks/v1/by-fingerprint/<FP> you@server
daedalus gpgtools send_pubkey --pubkey "ssh-ed25519 AAAA... comment" you@server
daedalus gpgtools send_pubkey --yubikey --dry-run you@server # resolve only
| Argument | Default | Meaning |
|---|---|---|
--yubikey |
— | Key from the plugged YubiKey via gpg-agent (must be the only agent key) |
--url URL |
— | Armored OpenPGP public key at a URL ([A] subkey is exported) |
--fingerprint FP |
— | Searched: local keyring → keys.openpgp.org → keyserver.ubuntu.com |
--pubkey LINE |
— | The literal SSH public key line |
--no-verify |
verification on | Skip the proof-of-possession signature (explicit risk acceptance) |
--dry-run |
off | Resolve and print the key; verify and send nothing |
Additional exit codes: 7 ssh to the target failed, 8 no source
resolved a key, 10 proof-of-possession verification failed (nothing
was sent).
Shell completion
Bash (and other shells argcomplete supports) completes script names and
category labels: daedalus hel + TAB completes hello, daedalus test h +
TAB completes hello inside the category, and options complete after -.
See INSTALL.
Getting started
- Clone or copy this template and name the Git remote for your team.
- Add a script under
python/src/,bash/,powershell/, orbatch/(see SPEC layout); bash scripts implement the sharedhelp()interface (SPEC item 6.10). - Register it in
daedalus/registry.py, add a row to the table above, write tests, bumpversioninpyproject.toml, and runpython autotest.py.
hello is the sample script: copy its file, registry entry, README row,
and tests to add your own. Unknown names exit with code 2 and suggest
close matches.