Devtools

A bunch of useful tools. Designed by human. Made by codex.

• 🌱 seed: gitsync; entry point tools/gitsync/bin/gitsync; inspect fetch/worktree status and safely synchronize cron-scheduled Git repositories with optional post-sync hooks using launchd
• 🌳 oak: tokemon ; entry point tools/tokemon/bin/tokemon; report token usage from local Codex and Claude session logs, including the data backend used by the Tokemon menu app
• 🌳 oak: jsonlint ; entry point tools/jsonlint/bin/jsonlint; validate JSON from a file path or stdin
• 🌳 oak: mdpaste ; entry point tools/mdpaste/bin/mdpaste; convert Markdown in the clipboard into rich text for paste targets like Gmail and Google Docs
• 🌳 oak: mdpreview ; entry point tools/mdpreview/bin/mdpreview; render Markdown from stdin or a file into a localhost preview page with markdown-it plugins
• 🌳 oak: fishy ; entry point tools/fishy/bin/fishy; open an editable Mermaid playground or serve previews from stdin, a Mermaid file, or Markdown source blocks
• 🪴 sprout: cozy; entry point tools/cozy/bin/cozy; manage localhost services from a cute admin dashboard with live refresh, per-site restart, and add-service controls
• 🪴 sprout: arbor ; entry point tools/arbor/bin/arbor; manage git branches/worktrees with merged cleanup, multi-target removal, branch-to-worktree and worktree-to-main conversion, and force-with-lease pushing
• 🪴 sprout: diff ; entry point tools/diff/bin/diff; show a git diff from the current working tree against the most recent commit at or before a relative cutoff, with optional --name-only
• 🪴 sprout: tokemon-menuapp ; entry point apps/tokemon-menuapp/bin/tokemon-menuapp; build and launch the native Tokemon macOS menu-bar app
• 🌱 seed: agent-sync ; entry point tools/agent-sync/bin/agent-sync; bidirectionally sync selected agent-config files between a live folder and a git repo with file-level conflict detection and dry-run preview
• 🌱 seed: autocrop-video ; entry point tools/autocrop-video/bin/autocrop-video; detect the embedded video frame inside a larger screen recording and optionally crop the file to that box
• 🌱 seed: codex-tmux; entry point tools/codex-tmux/bin/codex-tmux; inventory tmux panes with running Codex processes and infer their visible state
• 🌱 seed: ag-man ; entry point tools/ag-man/bin/ag-man; list today's ag-ledger session starts as JSONL with active/inactive process and tmux status, with optional --filter key=value and --group-by workspace
• 🌱 seed: claw-debug; entry point tools/claw-debug/bin/claw-debug; dump local OpenClaw session debug files for one session key
• 🌱 seed: convo ; entry point tools/convo/bin/convo; search Codex conversation logs with fast regex matching and optional date-window filtering
• 🌱 seed: epoch; entry point tools/epoch/bin/epoch; convert an epoch timestamp into UTC, local, and relative time
• 🌱 seed: jwtio; entry point tools/jwtio/bin/jwtio; decode a JWT from stdin into pretty JSON showing the header, payload, and signature fields
• 🌱 seed: slack-post; entry point tools/slack-post/bin/slack-post; post a plain-text message to a Slack channel with a provided token
• 🌱 seed: sshx ; entry point tools/sshx/bin/sshx; sync configured profile-selected local dotfiles plus Codex CLI config, agents, hooks, rules, and skills to a remote host with rsync or tar-over-ssh fallback, then open ssh with optional identity and SSH options

• 🪴 sprout: comodoro; app path apps/comodoro; native macOS menu-bar Pomodoro timer with phase-colored progress, configurable cycles, and focus history
• 🌱 seed: ctrl-tab-chrome; app path apps/ctrl-tab-chrome; local Chrome extension that makes Ctrl+Tab switch to the last used tab on normal web pages

• beethoven
• configsync

tools/<project>/ or apps/<project>/
  README.md
  AGENTS.md  # Only when the project needs agent-specific instructions.
  bin/
  docs/
  playbooks/
  specs/
  src/

Project directories contain only the optional subdirectories they actually need. Run scripts/install.sh to symlink project-owned executable entry points into ~/.local/bin; set INSTALL_BIN_DIR to choose a different destination. Add the installation directory to your shell PATH. LaunchAgents should use the installed executable paths, while shared tests invoke project-owned entry points directly.

Runtime configuration lives outside the repository under ~/.config/<tool>/ or ~/.config/<application>/. Its portable chezmoi source lives in ~/agents/config/, which synchronizes managed settings into the home directory. Source and build manifests, including package.json, tsconfig.json, and Chrome extension manifest.json, remain in their projects because they describe the implementation rather than machine-local settings.