Reading the repo
Opening the box…
Reading the repo
Opening the box…
How to install on macOS
AI agent skill that researches any topic across Reddit, X, YouTube, HN, Polymarket, and the web - then synthesizes a grounded summary
Saved setup from 1 h ago
Will it work on macOS?
CONTRIBUTING.mdThanks for helping with last30days. Most PRs here are opened by coding agents following AGENTS.md; this file is the short path for humans and agents alike.
Python 3.12+. From the repo root:
uv sync --group dev
uv run pytest
That installs pytest/coverage and towncrier into the project env. You do not need a global towncrier install for normal contributions.
# Prefer the PR or issue number when you know it:
# changelog.d/<number>.<type>.md
# Orphan (no number yet):
# changelog.d/+short-slug.<type>.md
Types: added, changed, fixed, removed, deprecated, security.changelog.d/README.md..github/PULL_REQUEST_TEMPLATE.md — Summary (“what does this PR do”), Testing, Changelog, Agent disclosure, Relationship.CHANGELOG.md and do not bump version strings in pyproject.toml, SKILL.md, plugin/marketplace JSON, or uv.lock. CI enforces that.Chores with nothing for the release notes: check Skip changelog in the template and add the skip-changelog label. Dependabot PRs skip that requirement automatically.
Fragments are plain Markdown files. towncrier is only used when cutting a release (locally via uv run or in GitHub Actions) — contributors never run it for a feature PR.
Prefer Actions → Prepare release (patch / minor / major). That opens a lockstep version PR (towncrier builds CHANGELOG.md, bumps every plugin/marketplace surface). Merging to main tags vX.Y.Z and the existing Release workflow publishes artifacts.
Local equivalent (after uv sync --group dev):
uv run python .github/scripts/prepare_release.py --bump patch # or --version X.Y.Z
More detail: AGENTS.md § Changelog and releases, and docs/solutions/workflow-issues/towncrier-lockstep-release.md.
uv run pytest
uv run pytest tests/test_dedupe_v3.py -k some_case
uv run pytest --cov
Never commit real API keys, cookies, tokens, or .env contents. Use dummy values in tests and fixtures.
Then run bash setup.sh. It stops at the first error and is safe to run again. Servers and tests aren't started; it lists them at the end. Read it first.
Needs Git: xcode-select --install
git clone https://github.com/mvanhorn/last30days-skill.git cd last30days-skill
Python >=3.12, Node.js
brew install uv brew install node
uv sync
uv run pytest
| Surface | Install | Updates |
|---------|---------|---------|
| Claude Code (recommended) | /plugin marketplace add mvanhorn/last30days-skill | Auto via marketplace, or claude plugin update last30days@last30days-skill |
| Grok (xAI Build CLI) | grok plugin marketplace add mvanhorn/last30days-skill then grok plugin install last30days | grok plugin update last30days |
| Grok Bot | Add it from the Grok Bot marketplace | Managed by the marketplace |
| Codex, Cursor, Copilot, Gemini CLI, or any of 50+ Agent Skills hosts | npx skills add mvanhorn/last30days-skill -g | npx skills update last30days -g |
| claude.ai (web) | Download last30days.skill and upload via claude.ai > Customize > Skills > + > Create skill > Upload a skill | Re-download and re-upload |
| Claude Desktop | Download the .mcpb for your platform and drag into Settings > Extensions | Re-download and drag the new bundle in |
| OpenClaw | clawhub install last30days-official | clawhub update last30days-official |
/plugin marketplace add mvanhorn/last30days-skill
Recommended because the Claude Code marketplace handles updates for you — the plugin cache is versioned and auto-refreshes when a new release publishes. Run claude plugin update last30days@last30days-skill to force a check.
If you'd rather use the agent-skills install path on Claude Code, that's also supported:
npx skills add mvanhorn/last30days-skill -g -a claude-code
Try Last30Days Research Skill in Telegram or WhatsApp
The native plugin and the npx skills install can coexist. Note that Claude Code does not dedupe across install methods: if you have both the marketplace plugin and the npx skills copy active, /last30days will show two entries. Use one install method per machine.
Grok Build (grok) installs last30days as a native plugin. Direct install tracks the repository:
grok plugin install mvanhorn/last30days-skill
Or add this repo as a marketplace source, then install by plugin name:
grok plugin marketplace add mvanhorn/last30days-skill
grok plugin install last30days
Add --trust to skip the install confirmation. Update with grok plugin update last30days. Grok also reads the Claude Code manifests for compatibility; the native .grok-plugin/ pair is the first-class lane (and what an official xAI marketplace listing points at). npx skills add remains a valid cross-host fallback. On Grok Bot, where last30days installs from the marketplace, X works out of the box through the bot's built-in X tools, then the bot's X connector, with the official X API (X_BEARER_TOKEN) as backup.
Install via the open Agent Skills CLI — supports 50+ harnesses including codex, cursor, github-copilot, gemini-cli, claude-code, windsurf, cline, continue, roo, aider-desk, opencode, goose, and more (full list on the vercel-labs/skills repo).
npx skills add mvanhorn/last30days-skill -g
The -g (global) flag installs to your user directory so the skill is available across all projects. Without -g, npx skills installs project-locally into ./.skills/ (committed with the repo). For a research-the-world tool, global is what you want.
Codex desktop and other folder-mode hosts can work in ordinary folders as well as Git repos. To inspect what a run would read and write without starting research, run the bundled scripts/last30days.py --preflight from the loaded skill directory; in a source checkout, the equivalent command is python3 skills/last30days/scripts/last30days.py --preflight. It shows the config source, browser-cookie plan, planned writes, optional commands, and ignored project config without reading cookies, writing files, or running research. First-run setup does not require it.
By default this installs for whichever harness npx skills detects. To target a specific one (or multiple):
npx skills add mvanhorn/last30days-skill -g -a codex
npx skills add mvanhorn/last30days-skill -g -a cursor
npx skills add mvanhorn/last30days-skill -g -a gemini-cli
npx skills add mvanhorn/last30days-skill -g -a codex -a cursor
Update later with:
npx skills update last30days -g
Or update everything you've instal
…
No reports for macOS yet.
GitManual AI Agent reads the 9 key files and writes a step-by-step guide for macOS. Once written, it's saved for everyone.