All notable changes to this project will be documented in this file.
- Restored browser-backed web auth for the current alphaXiv Better Auth session cookie flow, while preserving legacy browser bearer-token support.
- Scoped saved bearer and browser-cookie auth headers to
api.alphaxiv.orgrequests and allowed authenticated SDK/CLI flows to use either saved auth shape. - Updated paper comment creation, paper vote toggling, and PDF URL handling for the current web app endpoints and payloads.
- Expanded live smoke coverage for reversible authenticated comment and paper vote writes, public PDF URL checks, and assistant write flows.
- Refreshed auth, endpoint, CLI reference, development, and feature-spec documentation to match the current web app behavior.
- Added authenticated overview generation fallback for
alphaxiv paper overviewandAlphaXivClient.get_or_generate_overview(...), including--no-generatecontrols for read-only CLI behavior. - Added SDK support for requesting AI overview generation and polling overview status through transient missing status or translation records after a successful generation request.
- Preserved actionable errors for unknown papers, failed overview jobs, failed translations, and permanent missing status records.
- Updated the paper reads/resources feature spec to document the generation endpoint, auth boundary, polling behavior, and smoke coverage.
- Added a repo-local spec system under
specs/withscripts/check_specs.pyvalidation for endpoint evidence, acceptance criteria, and release-facing feature contracts. - Added public discovery expansion with rich paper search through
client.search.papers_rich(...),alphaxiv search papers --rich, and the newclient.events.list()/alphaxiv events listevent surface. - Added expanded paper read sidecars for preview cards, figure URLs,
AI-detection results, and model-link matches through both SDK methods and
alphaxiv paperCLI commands. - Documented the expanded public read surfaces across the API inventory, CLI reference, Python API guide, development docs, and live public smoke coverage.
- Updated development dependency locks for the latest pytest and Pygments patch releases.
- Documented that long-running assistant chat sessions can slow down over time
because
assistant replykeeps extending the same remote session. - Added the current CLI mitigation: start a fresh chat with
assistant startand carry forward only the minimal recap or paper ids you still need, while keeping the older session available throughassistant historyorassistant list. - Updated the in-CLI assistant guide text and the shipped alphaXiv skill so users and agents both surface the same long-session warning and mitigation.
- Clarified the browser-backed auth operating model in the README and CLI
reference, including that
alphaxiv auth login-webis one-time setup tied to a persistentALPHAXIV_HOMEand browser profile. - Updated the shipped alphaXiv skill and reference files so assistant auth guidance reflects the restored web-login path instead of describing assistant commands as API-key-only.
- Synced the lockfile package version to
0.4.1.
- Restored optional browser-backed auth through
alphaxiv auth login-web,alphaxiv auth clear-web, and savedauth.json/ browser-profile support. - Updated assistant commands to prefer the saved web login when it is available, while keeping API-key auth for the rest of the authenticated CLI surface.
- Added SDK support for explicit bearer auth plus
AlphaXivClient.from_saved_browser_auth()andAlphaXivClient.from_saved_auth(prefer_browser=True). - Expanded unit, integration, and live smoke coverage for the restored browser auth flow, including assistant write smoke that can seed browser-backed auth from the operator's real alphaXiv session when available.
- Restored the optional
browserdependency extra for Playwright-backed auth flows and documented the new assistant auth behavior in the CLI and Python docs.
- Added NotebookLM-style agent UX improvements with built-in
guide,skill, andagentcommand groups. - Added stable
--jsonoutput across the main read and discovery commands for agent-safe structured output, while keeping--rawas the backend-shaped debug surface. - Added packaged runtime assets and install/status/show/uninstall flows for Codex, Claude Code, and OpenCode integrations.
- Added representative live JSON smoke coverage for
feed,assistant, andfoldersreads, plus unit coverage for the new guide, skill, and JSON surfaces.
- Reorganized the CLI around resource-first groups such as
auth,context,search,feed,paper,assistant, andfolders. - Expanded the paper surface with abstract, summary, overview, PDF, full-text,
comments, similar-paper, and paper-folder workflows under
alphaxiv paper. - Added authenticated comment create, reply, delete, and upvote support plus authenticated paper-folder membership management.
- Added folder membership CLI coverage and live smoke coverage for feed and folder flows.
- Improved CLI discoverability with richer help text, suggestion-oriented error messages, and nearest-command guidance for agent and terminal use.
- Added a repo-shipped optional Codex skill for alphaXiv CLI research workflows.
Initial public release.
- Added an API-key-only SDK and CLI for alphaXiv.
- Implemented public search, feed, paper metadata, overview, transcript, PDF, comments, and similar-paper endpoints.
- Implemented authenticated assistant, folder, paper-vote, and comment-mutation flows.
- Added live smoke coverage for public feed, paper reads, assistant reads, folders, and reversible authenticated mutations.