Plugin index

Command → plugin file → primary lib modules → secrets/env vars.

Plugins are thin Cinch handlers; logic lives in lib/. Every plugin should have a # Help: line (parsed by !help). See AGENTS.md and LIB_INDEX.md.

Secrets reference: README.md, lib/AU_APIS.md, lib/QLD_APIS.md.

Theme migration: ~90 plugins wired for !theme use recolouring — see THEME_MIGRATION.md. Admin: !theme, !paint (owner bot).

AI and build

Command Plugin Primary lib(s) Secrets
!ai plugins/ai.rb ai_access, ai_chat_core, ai_agent CURSOR_SESSION_TOKEN
!aip plugins/aip.rb ai_plan_session, ai_plan_agent CURSOR_SESSION_TOKEN
!draw plugins/draw.rb draw_core, draw_session, dcc_image_hooks, ai_access CURSOR_SESSION_TOKEN
!comic plugins/comic.rb comic_core, draw_core, ai_access CURSOR_SESSION_TOKEN
!wget plugins/wget.rb ai_access, image_wget, google_drive_api CURSOR_SESSION_TOKEN; GOOGLE_DRIVE_API_KEY
!recipe plugins/recipe.rb ai_recipe_capture, recipe_store CURSOR_SESSION_TOKEN
!pies plugins/pies.rb ai_agent, ai_guard CURSOR_SESSION_TOKEN
!rabbot plugins/rabbot_meta.rb rabbot_meta_agent, rabbot_meta_build, rabbot_meta_queue CURSOR_SESSION_TOKEN
!hf plugins/huggingface.rb ai_access, rabbot_db Per-user HF token (PM login)

Catalogue and lookup

Command Plugin Primary lib(s) Secrets
!auslib plugins/auslib.rb auslib_search → .lookup Trove API key
!qldlibrary plugins/qldlibrary.rb qldlibrary_search —
!qldmuseum plugins/qldmuseum.rb qldmuseum_search —
!staticice plugins/staticice.rb staticice_search, staticice_report —
!car plugins/car.rb car_search, car_report —
!man plugins/man.rb man_lookup —
!wine plugins/wine.rb winehq_search —
!tm plugins/tm.rb tm_search, tm_game IPAUSTRALIA_API_KEY
!urban plugins/urban.rb urban_lookup —
!url plugins/url.rb url_preview, url_link —
!wiki plugins/wiki.rb rabbot_http —
!google plugins/google.rb inline HTTP —
!duck plugins/duck.rb inline HTTP —
!define plugins/define.rb rabbot_http —
!dict plugins/dictionary.rb WordNet inline —
!arch plugins/arch.rb inline HTTP —

Events and places

Command Plugin Primary lib(s) Secrets
!whatson plugins/whatson.rb whatson_search, whatson_report —
!theatres plugins/theatres.rb theatres_search, theatres_report —
!geo plugins/geo.rb geo_lookup —
!globe plugins/globe.rb geo_lookup —
!distance plugins/distance.rb rabbot_http, fuel hints —
!maps plugins/maps.rb inline HTTP —
!sun plugins/sun.rb geo_lookup, sun_times —

QLD and transit

Command Plugin Primary lib(s) Secrets
!qld plugins/qld.rb qld_traffic, qld_translink_*, bom_warnings QLDTRAFFIC_API_KEY (optional)
!sunbus plugins/sunbus.rb sunbus_gtfs, sunbus_connect, sunbus_format —
shortcuts plugins/au_aliases.rb delegates to abs/govau/qld plugins varies

Government and open data

Command Plugin Primary lib(s) Secrets
!govau plugins/govau.rb govau_ckan, govau_ptv, govau_derby, … PTV_DEVID, PTV_KEY; TFNSW_API_KEY
!abs plugins/abs.rb abs_population, abs_showdown —
!aec plugins/aec.rb aec_results, aec_tally —
!fuel plugins/fuel.rb fuel_nsw, fuel_hunt FUEL_NSW_KEY, FUEL_NSW_SECRET
!rba plugins/rba.rb rba_rates, rba_rumble —

Directchat and bot admin

Command Plugin Primary lib(s) Secrets
!directchat plugins/directchat.rb directchat_session, directchat_mesh, directchat_wire —
!rabbot (bot) plugins/bot.rb bot_console, bot_identity —
!rabbot user plugins/rabbot_user.rb rabbot_db —
!botoption plugins/bot_options.rb bot_options, ai_model —
!veto plugins/veto.rb build_proposal_filter, veto_store —
!chat plugins/chat_mode.rb chat_mode_session, room_reader —
!logbook plugins/logbook.rb bot_log_store —
!asterisk plugins/asterisk.rb shell to local Asterisk —
character mentions plugins/character_responder.rb character_mention, character_profile —

Games

Command Plugin Primary lib(s) Secrets
!blackjack plugins/blackjack.rb game —
!poker plugins/poker.rb game —
!roulette plugins/roulette.rb game —
!pool plugins/pool.rb game —
!wheel plugins/wheel.rb game —
!bingo plugins/bingo.rb game, rabbot_db —
!solitaire plugins/solitaire.rb aisleriot_catalog, solitaire/* —
!battleships plugins/battleships.rb battleships_game, async_duel_handler —
!chain plugins/chain.rb async_duel_handler —
!rumor plugins/rumor.rb rumor_game —
!siege plugins/siege.rb siege_game —
!defduel plugins/defduel.rb async_duel_handler —
!pitch plugins/pitch.rb pitch_game —
!taboo plugins/taboo.rb taboo_game —
!timeline plugins/timeline.rb timeline_game —
!budget plugins/budget.rb budget_game —
!archdig plugins/archdig.rb archdig_game —
!rpg plugins/rpg.rb rpg_game —
!quake plugins/quake.rb quake_feed, quake_roulette —

Food and retail

Command Plugin Primary lib(s) Secrets
!kfc plugins/kfc.rb kfc_api, kfc_menu, kfc_stores —
!redrooster plugins/redrooster.rb red_rooster_api, red_rooster_menu PM login for promos
!beer plugins/beer.rb inline HTTP —
!pizza plugins/pizza.rb inline HTTP —
!pubcrawl plugins/pubcrawl.rb inline HTTP —

News and media

Command Plugin Primary lib(s) Secrets
!news plugins/news.rb rabbot_http —
!animal plugins/animal.rb animal_news —
!ducks / !spiders / !snakes / !crocodiles animal plugins animal_news —
!ala plugins/ala.rb ala_species, ala_myth —
!episode plugins/episode.rb athf_episode_index —
!trivia plugins/trivia.rb fandom_trivia, fandom_trivia_sources Fandom trivia from persona bots in channel (else all configured bots); Aussie fallback
!whatsnew plugins/whatsnew.rb whatsnew_feed, whatsnew_tracker —
!rss plugins/rss.rb rabbot_db —
!sing / !song sing/song plugins rabbot_http, message_progress —
!ozb plugins/ozb.rb rabbot_http —
!sports plugins/sports.rb rabbot_http —

Utility and channel

Command Plugin Primary lib(s) Secrets
!help plugins/help.rb help_parser, help_reply —
!web plugins/web.rb bot_sites, web_report —
!bom plugins/bom.rb bom_warnings, bom_poker —
!warn plugins/warn.rb bom_warnings —
!holidays plugins/holidays.rb holiday_calendar, holiday_store —
!calc plugins/calc.rb safe_calc —
!convert plugins/convert.rb unit_convert —
!bank plugins/bank.rb rabbot_db —
!credits plugins/credits.rb game_credits —
!quote plugins/quote.rb quote_store —
!remind / !reminder remind plugins async_job, rabbot_db —
!stats / !king stats/king channel_stats, rabbot_db —
!autoop plugins/autoop.rb list_command, rabbot_db —
!autovoice plugins/autovoice.rb rabbot_db —
!surf plugins/surf.rb rabbot_http —
!silence plugins/silence.rb inline —
!sms plugins/sms.rb Textbelt HTTP —
!dcc plugins/dcc.rb rabbot_db —

Fun and misc

Command Plugin Primary lib(s) Secrets
!clock plugins/clock.rb clock_flip, clock_report, clock_segment —
!time plugins/flip_time.rb clock_flip_store, clock_report —
!fart plugins/fart.rb inline PING —
!8ball plugins/eightball.rb inline —
!flip / !roll flip/roll inline —
!joke plugins/joke.rb rabbot_http —
!cocktail plugins/cocktail.rb rabbot_http —
!lotto plugins/lotto.rb rabbot_http —
!btop plugins/btop.rb inline shell —
!archey plugins/archey.rb shell —
!codestats plugins/codestats.rb inline —
!isit plugins/isit.rb inline —
!mircruby plugins/mircruby.rb rabbot_db —

Finding plugins not listed

grep -l '^# Help:' plugins/*.rb | wc -l   # all documented plugins
ruby -e 'puts Help.list_commands.map { _1[:command] }'  # from help system

Or search # Help: in plugins/ for the authoritative command string and responder scope.