Repository navigation
Agoras is a modular Python command-line utility for publishing, managing, and automating
posts across 10 major social networks including X, Facebook, Instagram, LinkedIn, Discord,
YouTube, TikTok, Threads, Telegram, and WhatsApp. Version 3.0 completes the platform-first
CLI: the legacy agoras publish command is gone, and credentials are stored under
app@account profiles, so several apps can drive the same account without overwriting
each other. Credentials supplied through environment variables keep working unchanged as a
self-contained profile.
Stored credentials are not read across this upgrade. Re-authorize every account once with
agoras <platform> authorize before the next post, then select a profile with
--profile when an account has more than one.
What's new in 3.0.0
Added
-
E2E: media replies, list-posts verify, and X thread in unattended suites. [Luis Alejandro Martínez Faneyth]
-
Document LinkedIn scope override and two-app authorize model. [Luis Alejandro Martínez Faneyth]
-
LinkedIn authorize --scope flag plumbing with env-safe scope key. [Luis Alejandro Martínez Faneyth]
-
LinkedIn authorize --scope override with sign-in default scopes. [Luis Alejandro Martínez Faneyth]
-
Fail CI when package dependencies drift out of sync. [Luis Alejandro Martínez Faneyth]
-
Wrapper-to-api seam integration tests (U5) [Luis Alejandro Martínez Faneyth]
-
Reply media backends, delete-reply, and E2E reply-cycle tests. [Luis Alejandro Martínez Faneyth]
-
Instagram media delete support. [Luis Alejandro Martínez Faneyth]
-
Resolve LinkedIn read media URNs and sanitize Discord read errors. [Luis Alejandro Martínez Faneyth]
-
Get-post and get-reply read actions across networks. [Luis Alejandro Martínez Faneyth]
-
Media-capable reply action across networks. [Luis Alejandro Martínez Faneyth]
Changed
-
Stored credentials must be re-authorized once after upgrade. [Luis Alejandro Martínez Faneyth]
-
Poll remote media status through one bounded helper. [Luis Alejandro Martínez Faneyth]
-
Give media, auth, and clients one explicit state each. [Luis Alejandro Martínez Faneyth]
-
Share one runner across CLI platform commands. [Luis Alejandro Martínez Faneyth]
-
Table-drive wrapper like, share, and delete handlers. [Luis Alejandro Martínez Faneyth]
-
Share credential, authorize, and main-shim wrapper plumbing. [Luis Alejandro Martínez Faneyth]
-
Share one driver across the platform-parity verify gates. [Luis Alejandro Martínez Faneyth]
-
Share API post-auth and disconnect hooks across platforms. [Luis Alejandro Martínez Faneyth]
-
Collapse legacy publish stub to one exit path. [Luis Alejandro Martínez Faneyth]
-
Lint: import sorting on normalized api modules. [Luis Alejandro Martínez Faneyth]
-
Normalize x/discord/telegram guards to ensure dialect (U4) [Luis Alejandro Martínez Faneyth]
-
Fix bare-root pytest collection via package chain (U1) [Luis Alejandro Martínez Faneyth]
-
Selectable credential profiles via app@account composite keys. [Luis Alejandro Martínez Faneyth]
-
Composite profile key in core token storage. [Luis Alejandro Martínez Faneyth]
Fixed
-
Report terminal states instead of collapsing them. [Luis Alejandro Martínez Faneyth]
-
Migrate Discord invite links to Luis Develops Community. [Luis Alejandro Martínez Faneyth]
-
Restore package version to 2.2.0 after premature 3.0.0 bump. [Luis Alejandro Martínez Faneyth]
-
TikTok authorize sends comma-separated scopes to the consent URL. [Luis Alejandro Martínez Faneyth]
-
Threads authorize accepts numeric user_id from Meta token responses. [Luis Alejandro Martínez Faneyth]
-
List-posts: LinkedIn q=author finder, Facebook deprecated attachment field, object-id + retry in E2E helper. [Luis Alejandro Martínez Faneyth]
-
X list-posts uses OAuth1 user context (user_auth) so timeline reads work. [Luis Alejandro Martínez Faneyth]
-
Clear X list-posts error when timeline read is gated by API tier. [Luis Alejandro Martínez Faneyth]
-
Reply-cycle YouTube upload uses unlisted privacy so comments are allowed. [Luis Alejandro Martínez Faneyth]
-
Document like as Community-Management-gated LinkedIn action. [Luis Alejandro Martínez Faneyth]
-
Keep object-id canonical for LinkedIn authorize identity to avoid composite drift. [Luis Alejandro Martínez Faneyth]
-
Restore w_member_social posting default and id_token identity for LinkedIn authorize. [Luis Alejandro Martínez Faneyth]
-
QA: stop echoing tokens on authorize and drop redundant env keys. [Luis Alejandro Martínez Faneyth]
-
QA: correct README import paths and drop dead helper return. [Luis Alejandro Martínez Faneyth]
-
QA findings on remaining-cleanup-tail: X ensure, reply guards, shared fakes. [Luis Alejandro Martínez Faneyth]
-
Harden credential-profile selection edge cases. [Luis Alejandro Martínez Faneyth]
Removed
-
Stop automatic pull request merges. [Luis Alejandro Martínez Faneyth]
-
Remove dead sheet, feed, media and CLI code paths. [Luis Alejandro Martínez Faneyth]
-
Remove deprecated credential forwarders (U3) [Luis Alejandro Martínez Faneyth]
-
Remove test-only delete_token and int timestamp compares (U2) [Luis Alejandro Martínez Faneyth]
Other
-
Fix(common): remove unused os import in version.py. [Cursor Agent]
-
Docs: ci probe for Cursor auto-approve pipeline. [Luis Alejandro Martínez Faneyth]
-
Test. [Luis Alejandro Martínez Faneyth]
-
Docs: apply docs-loop audit fixes. [Luis Alejandro Martínez Faneyth]
-
Docs: apply docs-loop audit fixes. [Luis Alejandro Martínez Faneyth]
-
Docs: apply docs-loop audit fixes. [Luis Alejandro Martínez Faneyth]
-
Docs: apply docs-loop audit fixes. [Luis Alejandro Martínez Faneyth]
-
Docs: apply docs-loop audit fixes. [Luis Alejandro Martínez Faneyth]
-
Refactor: derive LinkedIn --scope help default from auth constant. [Luis Alejandro Martínez Faneyth]
-
Chore(scripts): remove obsolete artifacts (R5) [Luis Alejandro Martínez Faneyth]
-
Refactor(platforms): collapse duplicate upload-timeout helpers (R4) [Luis Alejandro Martínez Faneyth]
-
Refactor(core): neutralize schedule hour format round-trip (R3) [Luis Alejandro Martínez Faneyth]
-
Refactor(common): replace hand-rolled level map with stdlib (R2) [Luis Alejandro Martínez Faneyth]
-
Refactor(media): MediaFactory class becomes module functions (R1) [Luis Alejandro Martínez Faneyth]
-
Fix(core,platforms,scripts,tests): address QA residuals round 2. [Luis Alejandro Martínez Faneyth]
-
Fix(tests,docs,scripts): QA findings on chunk-B branch. [Luis Alejandro Martínez Faneyth]
-
Feat(scripts,ci): vulture dead-code gate (R7, R8) [Luis Alejandro Martínez Faneyth]
-
Refactor(cli): remove dead content-spec constants (R6) [Luis Alejandro Martínez Faneyth]
-
Refactor(cli): remove unread registry metadata and get_platform_info (R5) [Luis Alejandro Martínez Faneyth]
-
Refactor(core)!: remove unconsumed re-export layers (R4) [Luis Alejandro Martínez Faneyth]
-
Refactor(cli,core,platforms)!: delete 11 dead platform and base methods (R3) [Luis Alejandro Martínez Faneyth]
-
Refactor(core): delete managers part 2 — sheet/feed dead methods, tests, README (R1, R2) [Luis Alejandro Martínez Faneyth]
-
Refactor(core,docs)!: delete FeedManager and SheetManager (R1) [Luis Alejandro Martínez Faneyth]
-
Test: stabilize discord asyncio suite under full platforms run. [Cursor Agent]
-
Fix(platforms,core,common): QA wave-3 findings (surface, encoding, contracts) [Luis Alejandro Martínez Faneyth]
-
Fix(core,platforms,common): QA findings on chunk A. [Luis Alejandro Martínez Faneyth]
-
Chore(deps): remove seven dependency pins and regenerate (R1-R5, R11) [Luis Alejandro Martínez Faneyth]
-
Refactor(platforms): tiktok/instagram retry loops to urllib3 Retry (R7) [Luis Alejandro Martínez Faneyth]
-
Fix(platforms): drop unused http.client import after retry swap. [Luis Alejandro Martínez Faneyth]
-
Refactor(platforms): youtube upload retry to googleapiclient num_retries (R7) [Luis Alejandro Martínez Faneyth]
-
Refactor(platforms): replace hand-rolled AuthorizedHttp with google_auth_httplib2 (R6) [Luis Alejandro Martínez Faneyth]
-
Refactor(common): replace beautifulsoup4 metatag scan with stdlib HTMLParser (R10) [Luis Alejandro Martínez Faneyth]
-
Refactor(core): replace dateutil with stdlib datetime in schedule (R9) [Luis Alejandro Martínez Faneyth]
-
Refactor(core): replace atoma RSS parser with stdlib (R8) [Luis Alejandro Martínez Faneyth]
-
Fix(core,scripts,docs): QA round 2 on decorator-residuals branch. [Luis Alejandro Martínez Faneyth]
-
Fix(core,scripts,tests): QA findings on decorator-residuals branch. [Luis Alejandro Martínez Faneyth]
-
Feat(scripts): api rate-limit parity gate (R8) [Luis Alejandro Martínez Faneyth]
-
Test(platforms): wrapper token-leak tests (R12) [Luis Alejandro Martínez Faneyth]
-
Fix(core,platforms): sanitize and sever wrapper re-chain sites (R11) [Luis Alejandro Martínez Faneyth]
-
Fix(core): serialize auto-auth first call and rate-limit buckets (R9, R10) [Luis Alejandro Martínez Faneyth]
-
Test(core,platforms): pin five unpinned guard behaviors (R3-R7) [Luis Alejandro Martínez Faneyth]
-
Fix(core): sanitized fail-safe raise in guard_error_wrap (R2) [Luis Alejandro Martínez Faneyth]
-
Refactor(core): type guard decorators against bound GuardableAPI protocol. [Luis Alejandro Martínez Faneyth]
-
Docs(migration): flip remaining present-tense publish references. [Luis Alejandro Martínez Faneyth]
-
Fix(cli,docs,tests): address QA findings on legacy publish removal. [Luis Alejandro Martínez Faneyth]
-
Style(cli): isort import order in main entry. [Luis Alejandro Martínez Faneyth]
-
Release: bump version to 3.0.0 (U5) [Luis Alejandro Martínez Faneyth]
-
Fix(cli): absorb arbitrary legacy args in the publish stub; finish test deletions. [Luis Alejandro Martínez Faneyth]
-
Docs(cli): flip publish references from deprecated to removed in 3.0 (U4) [Luis Alejandro Martínez Faneyth]
-
Test(cli): remove legacy publish tests, add stub tests, trim mixed files (U3) [Luis Alejandro Martínez Faneyth]
-
Refactor(cli): trim legacy conversion surface from converter (U2) [Luis Alejandro Martínez Faneyth]
-
Refactor(cli): remove legacy agoras publish command, add pointer stub (U1) [Luis Alejandro Martínez Faneyth]
-
Fix(core,scripts,tests): close #769 QA residuals — redaction, guard-order gate, discord flake. [Luis Alejandro Martínez Faneyth]
-
Test(platforms,scripts): close QA residuals on wrapper skeleton hoist. [Luis Alejandro Martínez Faneyth]
-
Fix(core,platforms): QA findings on wrapper skeleton hoist. [Luis Alejandro Martínez Faneyth]
-
Feat(platforms): migrate 9 wrappers to base skeleton (U3-U5) [Luis Alejandro Martínez Faneyth]
-
Feat(x): migrate wrapper to base skeleton (U2 pilot) [Luis Alejandro Martínez Faneyth]
-
Feat(core): hoist wrapper skeleton into SocialNetwork base (U1) [Luis Alejandro Martínez Faneyth]
-
Fix(core): avoid Bandit B107 on guard_token_presence default. [Cursor Agent]
-
Fix(core,platforms): QA round 2 — redaction, disconnect, deprecated forwarders. [Luis Alejandro Martínez Faneyth]
-
Fix(core): guard_token_presence degrades missing manager to not-authenticated. [Luis Alejandro Martínez Faneyth]
-
Fix(platforms): address QA findings on guard decorator refactor. [Luis Alejandro Martínez Faneyth]
-
Test(platforms): pin not-supported guard-skip (U9) [Luis Alejandro Martínez Faneyth]
-
Refactor(core,platforms): dedupe authenticate/disconnect into base (U7) [Luis Alejandro Martínez Faneyth]
-
Refactor(platforms): delete credential property forwarders (U6) [Luis Alejandro Martínez Faneyth]
-
Feat(threads,whatsapp,youtube): migrate api to guard decorators (U8) [Luis Alejandro Martínez Faneyth]
-
Feat(facebook,instagram,linkedin): migrate api to guard decorators (U5) [Luis Alejandro Martínez Faneyth]
-
Feat(x): migrate api to guard decorators (U4 assert dialect) [Luis Alejandro Martínez Faneyth]
-
Feat(discord,telegram): migrate api to guard decorators (U4) [Luis Alejandro Martínez Faneyth]
-
Feat(tiktok): migrate api to composable guard decorators. [Luis Alejandro Martínez Faneyth]
-
Feat(core): composable guard decorators for platform api operations. [Luis Alejandro Martínez Faneyth]
-
Docs(audit): guard-composition inventory for platform api refactor. [Luis Alejandro Martínez Faneyth]
-
Test(platforms): update Instagram API delete test for media delete support. [Cursor Agent]
-
Fix(tests): update Instagram API delete test for media delete support. [Cursor Agent]
-
Update. [Luis Alejandro Martínez Faneyth]
-
Test(platforms): update Instagram API delete test for media delete support. [Cursor Agent]
Read HISTORY for more info.
Full Changelog: 2.2.0...3.0.0