{"id":15512098,"url":"https://github.com/guedesfelipe/pls-cli","last_synced_at":"2026-03-05T11:04:06.411Z","repository":{"id":41147511,"uuid":"504569476","full_name":"guedesfelipe/pls-cli","owner":"guedesfelipe","description":"Minimalist and full configurable greetings and TODO list","archived":false,"fork":false,"pushed_at":"2025-11-24T00:58:39.000Z","size":1271,"stargazers_count":161,"open_issues_count":12,"forks_count":15,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-11-24T01:08:02.809Z","etag":null,"topics":["cli","command-line","hacktoberfest","please","pls","pls-cli","python","pythoncli","terminal","todo","todo-cli"],"latest_commit_sha":null,"homepage":"https://guedesfelipe.github.io/pls-cli/","language":"Python","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/guedesfelipe.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","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},"funding":{"ko_fi":"guedesfelipe"}},"created_at":"2022-06-17T14:41:39.000Z","updated_at":"2025-11-23T23:57:19.000Z","dependencies_parsed_at":"2024-02-03T13:31:33.138Z","dependency_job_id":"4ac4fc66-9fab-416b-b82f-2d36ff1318d7","html_url":"https://github.com/guedesfelipe/pls-cli","commit_stats":null,"previous_names":[],"tags_count":10,"template":false,"template_full_name":null,"purl":"pkg:github/guedesfelipe/pls-cli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/guedesfelipe%2Fpls-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/guedesfelipe%2Fpls-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/guedesfelipe%2Fpls-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/guedesfelipe%2Fpls-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/guedesfelipe","download_url":"https://codeload.github.com/guedesfelipe/pls-cli/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/guedesfelipe%2Fpls-cli/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30121090,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-05T10:44:24.758Z","status":"ssl_error","status_checked_at":"2026-03-05T10:44:15.079Z","response_time":93,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["cli","command-line","hacktoberfest","please","pls","pls-cli","python","pythoncli","terminal","todo","todo-cli"],"created_at":"2024-10-02T09:53:25.920Z","updated_at":"2026-03-05T11:04:06.386Z","avatar_url":"https://github.com/guedesfelipe.png","language":"Python","readme":"\u003ch1 align=\"center\"\u003e\n  💻 PLS-CLI\n\u003c/h1\u003e\n\u003cp align=\"center\"\u003e\n    \u003ca href=\"https://github.com/guedesfelipe/pls-cli/actions/workflows/ci.yml\" target=\"_blank\"\u003e\n        \u003cimg src=\"https://github.com/guedesfelipe/pls-cli/actions/workflows/ci.yml/badge.svg?branch=main\" /\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://github.com/guedesfelipe/pls-cli/actions/workflows/security.yml\" target=\"_blank\"\u003e\n        \u003cimg src=\"https://github.com/guedesfelipe/pls-cli/actions/workflows/security.yml/badge.svg?branch=main\" /\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://codecov.io/gh/guedesfelipe/pls-cli\" \u003e \n      \u003cimg src=\"https://codecov.io/gh/guedesfelipe/pls-cli/branch/main/graph/badge.svg\"/\u003e \n    \u003c/a\u003e\n    \u003ca href=\"https://pypi.org/project/pls-cli/\" target=\"_blank\"\u003e\n      \u003cimg src=\"https://img.shields.io/pypi/v/pls-cli?label=pypi%20package\" /\u003e\n    \u003c/a\u003e\n    \u003ca href=\"\" target=\"_blank\"\u003e\n      \u003cimg src=\"https://img.shields.io/pypi/pyversions/pls-cli.svg?color=green\u0026logo=python\u0026logoColor=yellow\" /\u003e\n    \u003c/a\u003e\n    \u003cimg src=\"https://img.shields.io/badge/platforms-windows%7C%20linux%7C%20macos-lightgrey\" /\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cem\u003eIf you are like me, and your terminal is your home, this CLI will make your life better, I hope 😄\u003c/em\u003e\n  \u003cbr\u003e\n  \u003cbr\u003e\n  \u003cimg src=\"https://user-images.githubusercontent.com/25853920/180621358-bf89cd86-2109-41e7-9fea-bbd1a6a56ff4.gif\" /\u003e\n\u003c/p\u003e\n\n# 🛠 Installation\n\n```sh\npip install pls-cli\n```\n\n# ⬆️ Upgrade version\n\n```sh\npip install pls-cli --upgrade\n```\n\n# ⚙️ Configuration\n\nTo run **`pls-cli`** everytime you open your shell's:\n\n\u003cdetails\u003e\u003cp\u003e\u003csummary\u003eBash\u003c/p\u003e\u003c/summary\u003e\n\n```sh\necho 'pls' \u003e\u003e ~/.bashrc\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\u003cp\u003e\u003csummary\u003eZsh\u003c/p\u003e\u003c/summary\u003e\n\n```sh\necho 'pls' \u003e\u003e ~/.zshrc\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\u003cp\u003e\u003csummary\u003eFish\u003c/p\u003e\u003c/summary\u003e\n\n```sh\necho 'pls' \u003e\u003e ~/.config/fish/config.fish\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\u003cp\u003e\u003csummary\u003eIon\u003c/p\u003e\u003c/summary\u003e\n  \n```sh\necho 'pls' \u003e\u003e ~/.config/ion/initrc\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\u003cp\u003e\u003csummary\u003eTcsh\u003c/p\u003e\u003c/summary\u003e\n  \n```sh\necho 'pls' \u003e\u003e ~/.tcshrc\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\u003cp\u003e\u003csummary\u003eXonsh\u003c/p\u003e\u003c/summary\u003e\n\n```sh\necho 'pls' \u003e\u003e ~/.xonshrc\n```\n\u003c/details\u003e\n\n\u003cdetails\u003e\u003cp\u003e\u003csummary\u003ePowershell\u003c/p\u003e\u003c/summary\u003e\n    \nAdd the following to the end of `Microsoft.PowerShell_profile.ps1`. You can check the location of this file by querying the `$PROFILE` variable in PowerShell. Typically the path is `~\\Documents\\PowerShell\\Microsoft.PowerShell_profile.ps1` or `~/.config/powershell/Microsoft.PowerShell_profile.ps1` on -Nix.\n \n```txt\npls\n```\n\n\u003c/details\u003e\n\n⚠️ Restart your terminal to apply the changes and start configuring your PLS-CLI. 🎉\n\n# ⌨️ Commands\n\n```sh\npls --help\n```\n\nOr for more information you can see in the [documentation](https://guedesfelipe.github.io/pls-cli/commands).\n\n\n# 🎨 Color Configuration\n\nYou can configure all colors with envs!!\n\n\u003cdetails\u003e\u003cp\u003e\u003csummary\u003eSetting env on Linux, macOS, Windows Bash:\u003c/p\u003e\u003c/summary\u003e\n\n```sh\nexport PLS_ERROR_LINE_STYLE=\"#e56767\"\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\u003cp\u003e\u003csummary\u003eSetting env on Windows PowerShell:\u003c/p\u003e\u003c/summary\u003e\n\n```sh\n$Env:PLS_ERROR_LINE_STYLE = \"#e56767\"\n```\n\n\u003c/details\u003e\n\nAll envs:\n```sh\nexport PLS_ERROR_LINE_STYLE=\"#e56767\"\nexport PLS_ERROR_TEXT_STYLE=\"#ff0000 bold\"\n\nexport PLS_WARNING_LINE_STYLE=\"#FFBF00\"\nexport PLS_WARNING_TEXT_STYLE=\"#FFBF00 bold\"\n\nexport PLS_UPDATE_LINE_STYLE=\"#61E294\"\nexport PLS_UPDATE_TEXT_STYLE=\"#61E294 bold\"\n\nexport PLS_INSERT_DELETE_LINE_STYLE=\"#bb93f2\"\n\nexport PLS_INSERT_DELETE_TEXT_STYLE=\"#a0a0a0\"\n\nexport PLS_MSG_PENDING_STYLE=\"#61E294\"\nexport PLS_TABLE_HEADER_STYLE=\"#d77dd8\"\nexport PLS_TASK_DONE_STYLE=\"#a0a0a0\"\nexport PLS_TASK_PENDING_STYLE=\"#bb93f2\"\nexport PLS_HEADER_GREETINGS_STYLE=\"#FFBF00\"\nexport PLS_QUOTE_STYLE=\"#a0a0a0\"\nexport PLS_AUTHOR_STYLE=\"#a0a0a0\"\n\nexport PLS_BACKGROUND_BAR_STYLE=\"bar.back\"\nexport PLS_COMPLETE_BAR_STYLE=\"bar.complete\"\nexport PLS_FINISHED_BAR_STYLE=\"bar.finished\"\n```\n\n\u003cdetails\u003e\u003cp\u003e\u003csummary\u003eYou can specify the background color like this:\u003c/p\u003e\u003c/summary\u003e\n\n```sh\nexport PLS_QUOTE_STYLE=\"#a0a0a0 on blue\"\n```\n\n\u003c/details\u003e\n\nIf you create some theme, share with us \u003ca href=\"https://github.com/guedesfelipe/pls-cli/discussions/1#discussion-4174647\" target=\"_blank\"\u003ehere\u003c/a\u003e ♥️.\n\n## 💄 Formatting a task\n\n\u003cdetails\u003e\u003cp\u003e\u003csummary\u003eYou can format your tasks with:\u003c/p\u003e\u003c/summary\u003e\n\n```sh\npls add \"[b]Bold[/], [i]Italic[/], [s]Strikethrough[/], [d]Dim[/], [r]Reverse[/], [red]Color Red[/], [#FFBF00 on green]Color exa with background[/], :star:, ✨\"\n```\n\n![image](https://user-images.githubusercontent.com/25853920/175835339-8059bc7e-0538-4e2d-aed8-80487d7b2478.png)\n\n\u003c/details\u003e\n\n## 🚧 TMUX integration\n\nUsing `pls count-done` and `pls count-undone`.\n\n## 🤝 Special thanks\n\n**PLS-CLI** stands on the shoulders of giants:\n\n* \u003ca href=\"https://github.com/tiangolo/typer\" target=\"_blank\"\u003eTyper\u003c/a\u003e for the CLI tool.\n* \u003ca href=\"https://github.com/Textualize/rich\" target=\"_blank\"\u003eRich\u003c/a\u003e for the beautiful formatting in terminal.\n\n---\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://ko-fi.com/guedesfelipe\" target=\"_blank\"\u003e\n    \u003cimg src=\"https://user-images.githubusercontent.com/25853920/175832199-6c75d866-31b8-4209-bd1a-db116a6dd032.png\" width=300 /\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n","funding_links":["https://ko-fi.com/guedesfelipe"],"categories":["Python"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fguedesfelipe%2Fpls-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fguedesfelipe%2Fpls-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fguedesfelipe%2Fpls-cli/lists"}