{"id":35277139,"url":"https://github.com/radulucut/cleed","last_synced_at":"2025-12-30T14:04:38.878Z","repository":{"id":253053798,"uuid":"842305716","full_name":"radulucut/cleed","owner":"radulucut","description":"Feed reader for the command line.","archived":false,"fork":false,"pushed_at":"2025-09-28T17:23:46.000Z","size":339,"stargazers_count":203,"open_issues_count":3,"forks_count":6,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-11-21T04:08:28.076Z","etag":null,"topics":["atom","cli","feed","go","reader","rss","terminal"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/radulucut.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-08-14T04:48:06.000Z","updated_at":"2025-11-14T01:17:10.000Z","dependencies_parsed_at":"2024-08-28T13:47:27.043Z","dependency_job_id":"336f3bb7-d376-4fb9-9cf7-9078ec1514c5","html_url":"https://github.com/radulucut/cleed","commit_stats":null,"previous_names":["radulucut/cleed"],"tags_count":18,"template":false,"template_full_name":null,"purl":"pkg:github/radulucut/cleed","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/radulucut%2Fcleed","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/radulucut%2Fcleed/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/radulucut%2Fcleed/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/radulucut%2Fcleed/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/radulucut","download_url":"https://codeload.github.com/radulucut/cleed/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/radulucut%2Fcleed/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28127973,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-12-30T02:00:05.476Z","response_time":64,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["atom","cli","feed","go","reader","rss","terminal"],"created_at":"2025-12-30T14:01:37.272Z","updated_at":"2025-12-30T14:04:38.871Z","avatar_url":"https://github.com/radulucut.png","language":"Go","funding_links":[],"categories":["Go"],"sub_categories":[],"readme":"# cleed\n\nSimple feed reader for the command line.\n\n![Test](https://github.com/radulucut/cleed/actions/workflows/tests.yml/badge.svg)\n\n![Screenshot](./screenshot.png)\n\n## Installation\n\n#### MacOS - Homebrew\n\n```bash\nbrew tap radulucut/cleed\nbrew install cleed\n```\n\n#### Windows - Scoop\n\n```bash\nscoop bucket add cleed https://github.com/radulucut/scoop-cleed\nscoop install cleed\n```\n\n#### From source\n\n```bash\ngo run main.go\n```\n\n#### Binary\n\nDownload the latest binary from the [releases](https://github.com/radulucut/cleed/releases) page.\n\n## Usage\n\n#### Follow a feed\n\n```bash\n# Add a feed to the default list\ncleed follow https://example.com/feed.xml\n\n# Add multiple feeds to a list\ncleed follow https://example.com/feed.xml https://example2.com/feed --list mylist\n```\n\n#### Display feeds\n\n```bash\n# Display feeds from all lists\ncleed\n\n# Display feeds from a specific list\ncleed --list my-list\n\n# Display feeds since a specific date\ncleed --since \"2024-01-01 12:03:04\"\n\n# Display feeds since a specific period\ncleed --since \"1d\"\n\n# Display feeds since the last run\ncleed --since last\n\n# Display feeds from a specific list and limit the number of items\ncleed --list my-list --limit 10\n\n# Search for items\ncleed --search \"keyword\" --limit 10\n\n# Search for items in cached feeds\ncleed --search \"keyword\" -C\n\n# Search for items using a regular expression (https://github.com/google/re2/wiki/Syntax)\ncleed --searchr \"^keyword\"\n\n# Search for items using a regular expression case insensitive\ncleed --searchr \"(?i)keyword\"\n\n# Using a proxy\ncleed --proxy socks5://user:password@proxy.example.com:8080\n```\n\n#### Unfollow a feed\n\n```bash\n# Remove a feed from the default list\ncleed unfollow https://example.com/feed.xml\n\n# Remove multiple feeds from a list\ncleed unfollow https://example.com/feed.xml https://example2.com/feed --list mylist\n```\n\n#### List feeds\n\n```bash\n# Show all lists\ncleed list\n\n# Show all feeds in a list\ncleed list mylist\n\n# Rename a list\ncleed list mylist --rename newlist\n\n# Merge a list. Move all feeds from anotherlist to mylist and remove anotherlist\ncleed list mylist --merge anotherlist\n\n# Remove a list\ncleed list mylist --remove\n\n# Import feeds from a file\ncleed list mylist --import-from-file feeds.txt\n\n# Import feeds from an OPML file\ncleed list mylist --import-from-opml feeds.opml\n\n# Export feeds to a file\ncleed list mylist --export-to-file feeds.txt\n\n# Export feeds to an OPML file\ncleed list mylist --export-to-opml feeds.opml\n\n# Export only cached feeds to an OPML file\ncleed list --export-to-opml feeds.opml -C\n```\n\n#### Configuration\n\n```bash\n# Display configuration\ncleed config\n\n# Set the user agent\ncleed config --user-agent=\"My User Agent\"\n\n# Disable styling\ncleed config --styling=2\n\n# Map color 0 to 230 and color 1 to 213\ncleed config --map-colors=0:230,1:213\n\n# Remove color mapping for color 0\ncleed config --map-colors=0:\n\n# Clear all color mappings\ncleed config --map-colors=\n\n# Display color range. Useful for finding colors to map\ncleed config --color-range\n\n# Enable run summary\ncleed config --summary=1\n\n# Set the miniflux token\ncleed config --miniflux-token=\"your_token_here\"`\n```\n\n\u003e **Color mapping**\n\u003e\n\u003e You can map the colors used in the feed reader to any color you want. This is useful if certain colors are not visible in your terminal based on the color scheme that you are using.\n\u003e\n\u003e Run `cleed config --color-range` to see the color range and map the colors that you want using the `cleed config --map-colors` command.\n\n#### Miniflux\n\n```bash\n# Push feeds to Miniflux\ncleed miniflux push\n\n# Pull feeds from Miniflux\ncleed miniflux pull\n```\n\n#### Explore feeds\n\n```bash\n# Explore feeds from the default repository (https://github.com/radulucut/cleed-explore)\ncleed explore\n\n# Fetch the latest changes and explore feeds from the default repository\ncleed explore --update\n\n# Explore feeds from a repository\ncleed explore https://github.com/radulucut/cleed-explore.git\n\n# Limit the number of items to display from each list\ncleed explore --limit 5\n\n# Search for items (title, description)\ncleed explore --search \"news\"\n\n# Import all feeds into my feeds\ncleed explore --import --limit 0\n\n# Import feeds from search results\ncleed explore --import --search \"news\"\n\n# Remove a repository\ncleed explore https://github.com/radulucut/cleed-explore.git --remove\n```\n\n\u003e **Note**\n\u003e\n\u003e The explore command expects git to be installed in order to fetch the repository, and it will only look at `.opml` files when exploring a repository.\n\n#### Custom data path\n\nYou can set the `CLEED_DATA_PATH` environment variable to specify a custom path for the data directory. All data will be stored in this directory (config, cache, etc).\n\n#### Help\n\n```bash\ncleed --help\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fradulucut%2Fcleed","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fradulucut%2Fcleed","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fradulucut%2Fcleed/lists"}