ttyverse/AGENTS.md

TTYverse Agent Guide

Project Layout

• ttyverse.pl is the main (large) Perl script and source of truth.
• ttytter.pl is the original upstream script for reference.
• extensions/ contains optional extensions.
• ttyverse.wiki/ contains user and developer documentation.

Run

• ./ttyverse.pl
• perl ttyverse.pl
• ./ttyverse.pl -version

Testing

• No automated test suite is present.
• Minimum sanity check after edits: perl -c ttyverse.pl.
• Manual checks are expected (login, timelines, posting, notifications, media, polls).

Coding Standards

• Follow the existing code style in ttyverse.pl.
• New code should use camelCase variables, snake_case functions/methods, and PascalCase class names.
• For bash scripts, all variables must be camelCase (except system env vars). Run shellcheck on any edited bash script and fix issues.
• Log lines should be message [timestamp] (message first).

Accessibility

• Do not use Speech-Dispatcher or spd-say in GUI contexts.
• Prefer clear, complete labels and avoid keyboard traps.

System Interactions

• If a task requires sudo, ask the user to run it.