{"id":27234106,"url":"https://github.com/theycallmemac/larder","last_synced_at":"2025-10-13T01:38:31.367Z","repository":{"id":57534478,"uuid":"234928377","full_name":"theycallmemac/larder","owner":"theycallmemac","description":"A CLI for Larder.io","archived":false,"fork":false,"pushed_at":"2020-07-31T18:14:43.000Z","size":27,"stargazers_count":20,"open_issues_count":1,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-06-27T14:04:09.872Z","etag":null,"topics":["bookmarks","cli","cobra","command-line","command-line-tool","go","golang","larder","larder-cli","makefile"],"latest_commit_sha":null,"homepage":"https://larder.io","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/theycallmemac.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}},"created_at":"2020-01-19T16:18:54.000Z","updated_at":"2024-11-23T20:39:20.000Z","dependencies_parsed_at":"2022-09-26T18:21:35.961Z","dependency_job_id":null,"html_url":"https://github.com/theycallmemac/larder","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/theycallmemac/larder","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theycallmemac%2Flarder","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theycallmemac%2Flarder/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theycallmemac%2Flarder/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theycallmemac%2Flarder/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/theycallmemac","download_url":"https://codeload.github.com/theycallmemac/larder/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theycallmemac%2Flarder/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279013903,"owners_count":26085326,"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-10-12T02:00:06.719Z","response_time":53,"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":["bookmarks","cli","cobra","command-line","command-line-tool","go","golang","larder","larder-cli","makefile"],"created_at":"2025-04-10T15:23:51.700Z","updated_at":"2025-10-13T01:38:31.344Z","avatar_url":"https://github.com/theycallmemac.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 📚 larder\n\nA [Larder.io](https://larder.io) command line interface - for all us people who don't like browser extensions!\n\n## 🔧 Build\n\n#### Creating a Larder Client\n\nBefore installing the Larder CLI, you need to go to the [Larder app management page](https://larder.io/apps/clients/). You might have to log in first.\n\nYou need to create a new Client. It's pretty standard, nothing that will catch you off-guard, just fill out the form to create the Oauth2 Client. \n\n\n#### Larder Config\n\nOnce you've created your client, you can head to that clients information page and fetch the following tokens:\n- `access_token`\n- `refresh_token`\n- `client_id`\n- `client_secret`\n\nOnce you have these four tokens, store them in `~/.larder/config.yml` like so:\n\n``` yaml\naccess_token: $YOUR_ACCESS_TOKEN \nrefresh_token: $YOUR_REFRESH_TOKEN \nclient_id: $YOUR_CLIENT_ID\nclient_secret: $YOUR_CLIENT_SECRET\n```\n\n\nOnce you've stored your client information in `~/.larder/config.yml`, you are ready to build the CLI. To build, run `make install` in the top level of this repository. Requires sudo or root permissions.\n\n\n\n## 🚀 Usage\n\nYou can run the Larder CLI from anywhere by running the `larder` command\n\nYou can checkout the available commands with `larder --help`.\n\n#### Help\n\n```\nA CLI to your bookmarks\n\nUsage:\n  larder [command]\n\nAvailable Commands:\n  bookmark      interact with bookmarks\n  folder        interact with folders\n  help          Help about any command\n  refresh-token refresh your access token\n  search        search through bookmarks\n\nFlags:\n  -h, --help   help for larder\n```\n\n#### Folders\n\n```\nThis subcommand will allow the user to interact with folders\n\nUsage:\n  larder folder [flags]\n\nFlags:\n  -a, --add string      add a new folder\n  -d, --delete string   delete a folder\n  -h, --help            help for folder\n  -l, --list            list current folders\n  -s, --show string     show contents of a folder\n```\n\n#### Bookmarks\n\n```\nThis subcommand will allow the user to interact with bookmarks\n\nUsage:\n  larder bookmark [flags]\n\nFlags:\n  -a, --add string      add a new bookmark via url\n  -d, --delete string   delete a bookmark via id\n  -f, --folder string   set folder to store a bookmark in - (required)\n  -h, --help            help for bookmark\n  -i, --id              get the id's of each bookmark in a folder\n\n```\n\nAs seen above, the `-f` / `--folder` paramter is always required. This means that when adding, removing or dispalying bookmark id's a destination folder must always be provided.\n\n#### Searching\n\n```\nThis subcommand will allow the user to search through bookmarks\n\nUsage:\n  larder search [flags]\n\nFlags:\n  -h, --help            help for search\n  -p, --params string   search by given parameters\n```\n\nThe `-p` / `--params` flag is a bt vague here. The user provides a string of search terms delimited by commas. For example: \"texas,bbq\". This will search through all folders, for names or tags containing those terms.\n\n#### Refreshing Access Tokens\n\nTokens expire in a month and can be refreshed for a new access token at any time, invalidating the original access and refresh tokens.\n\nTokens can be automatically refreshed by running `larder refresh-token`. \n\n## 👤 Author\n\n**James McDermott**\n\n- Email: \u003cjames.mcdermott7@mail.dcu.ie\u003e\n- Twitter: [@theycallmemac_](https://twitter.com/theycallmemac_)\n- Github: [@theycallmemac](https://github.com/theycallmemac)\n\n## ⭐️ Show your support\n\nGive a ⭐️ if this project helped you!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftheycallmemac%2Flarder","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftheycallmemac%2Flarder","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftheycallmemac%2Flarder/lists"}