mytoolkit

Personal CLI toolkit — unified entry point for everyday file conversion, format wrangling, and project chores.

Install

make install                                  # builds + symlinks ~/.local/bin/mytoolkit
mytoolkit --version
mytoolkit templates register ~/workspace/templates   # one-time, points at template root

Top-level commands

mytoolkit --help

Command	What it does
convert	Universal format conversion (md/img/pdf/eps/avi/bib → pdf/docx/tiff/mp4/md). Auto-detects from extensions.
pdf	compress / crop / merge / bookmark / to-tiff
image	compress / eps-fix / eps-to-pdf / jpg-to-pdf / tiff-to-pdf / tiff-compress / generate (Doubao/Seedream)
latex	compile / count
bib	to-markdown / cv-update
video	avi-to-mp4
webpage	Docusaurus build/list/rebuild/push
mail	IMAP/SMTP client (read/draft/forward/reply, no auto-send)
templates	Register and inspect external template root
env	Manage stored vars (api keys, paths, feishu app credentials)
ssh	list / connect / tunnel / cmd
git	proxy (set/unset/list/status)
server	Manage dev/serve servers
update	Reinstall from local repo
uninstall	Uninstall

For any subcommand: mytoolkit <cmd> --help.

Templates

mytoolkit convert -t <name> reads templates from an external directory you register (templates are not bundled). Layout:

<root>/md-to-pdf/<name>/template.typ
<root>/md-to-docx/<name>/template.docx

mytoolkit templates register /path/to/templates
mytoolkit templates list       # lists each template with its absolute path

Registry is stored at ~/.config/mytoolkit/templates.json.

User config

All user-level config lives under ~/.config/mytoolkit/:

File	Owner	Purpose
env.json	mytoolkit env	API keys, paths, feishu credentials (flat key/value)
mail.json	mytoolkit mail	IMAP/SMTP server settings
templates.json	mytoolkit templates	Pointer to external template root

Manage env vars via the CLI — no need to hand-edit:

mytoolkit env list                       # show all (Storage path printed at top, secrets masked)
mytoolkit env get apikey_ark             # read one
mytoolkit env set apikey_ark <value>     # write one
mytoolkit env set apikey_ark --secret    # prompt for value, hidden input
mytoolkit env remove apikey_ark          # delete one
mytoolkit env export                     # print MYCLI_FOO=... export statements
eval "$(mytoolkit env export)"           # load into current shell

Legacy bin/config.json (in the source dir) is auto-migrated to ~/.config/mytoolkit/env.json on first run after upgrade.

Uninstall

mytoolkit uninstall
# or
make uninstall

User config under ~/.config/mytoolkit/ is left in place.