reddit-cli_skill

Overview

This skill is a command-line Reddit client that uses your browser session cookies for authentication so no API key is required. It lets you read subreddit posts, run site-wide or subreddit searches, retrieve subreddit metadata, and test connection status. The tool is lightweight, respects Reddit rate limits, and is intended for personal use.

How this skill works

The CLI reads your reddit_session (and optional token_v2) cookie values from environment variables to authenticate requests as your logged-in session. It fetches posts by subreddit with configurable limits and sorting, performs search queries across Reddit or within a subreddit, and retrieves basic subreddit info. Commands are simple shells like posts, search, info, and check; cookies must be refreshed periodically when they expire.

When to use it

• Quickly browse hot/new/top posts from the terminal without an API key
• Search Reddit from scripts or automation tasks
• Retrieve subreddit metadata for monitoring or research
• Test whether your session cookies are valid and connection works
• Integrate into shell workflows or cron jobs for periodic checks

Best practices

• Store reddit_session and optional token_v2 in your shell environment (~/.bashrc) and keep the file secure
• Only use cookies from accounts you control; cookies grant the same access as your browser session
• Respect Reddit rate limits and avoid aggressive polling or scraping
• Refresh cookies periodically since session cookies expire
• Limit output or paginate when fetching many posts to avoid long waits

Example use cases

• View top 10 hot posts in a subreddit: reddit-cli posts programming 10
• Search Reddit for guides: reddit-cli search "python tutorial"
• Search inside a specific subreddit: reddit-cli search "help" --sub linux
• Fetch subreddit summary for monitoring: reddit-cli info AskReddit
• Verify authentication and connectivity: reddit-cli check