{"id":18295406,"url":"https://github.com/spiderpig86/gitta","last_synced_at":"2026-01-28T16:33:15.511Z","repository":{"id":44107853,"uuid":"201396334","full_name":"Spiderpig86/gitta","owner":"Spiderpig86","description":":octocat: Personalized git commit messages.","archived":false,"fork":false,"pushed_at":"2024-07-09T09:23:13.000Z","size":498,"stargazers_count":1,"open_issues_count":5,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-02-05T22:48:02.037Z","etag":null,"topics":["cli","commit","commit-emoji","conventional-commits","emojis","github","node","npm","typescript"],"latest_commit_sha":null,"homepage":"https://www.npmjs.com/package/gitta","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Spiderpig86.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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}},"created_at":"2019-08-09T05:29:37.000Z","updated_at":"2024-07-09T17:28:54.000Z","dependencies_parsed_at":"2024-11-05T14:43:19.787Z","dependency_job_id":"0c9ed659-c693-47de-8178-33feb2e0a43a","html_url":"https://github.com/Spiderpig86/gitta","commit_stats":{"total_commits":80,"total_committers":2,"mean_commits":40.0,"dds":"0.16249999999999998","last_synced_commit":"25b86c26b378cabe2b6322aa83c34ce761a9a351"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Spiderpig86%2Fgitta","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Spiderpig86%2Fgitta/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Spiderpig86%2Fgitta/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Spiderpig86%2Fgitta/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Spiderpig86","download_url":"https://codeload.github.com/Spiderpig86/gitta/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":242007909,"owners_count":20056818,"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","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","commit","commit-emoji","conventional-commits","emojis","github","node","npm","typescript"],"created_at":"2024-11-05T14:35:07.030Z","updated_at":"2026-01-28T16:33:15.471Z","avatar_url":"https://github.com/Spiderpig86.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 💎 Gitta\n\nA simple CLI to generate and format your commit messages with an emoji, type, and scope. Gitta aims to streamline your commit messages to follow consistently with the [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/) specification.\n\n## ✨ Features\n\n- Consistent commit messages every time.\n- Customizable emojis and prefixes.\n- Option to update from default or custom source for newly added emojis/prefixes.\n- Quick lookup for emojis.\n\n## 🚀 Installation\n\n```\nnpm i -g gitta\n```\n\n## ⚡ Commands\n\n### `gitta -c/--commit`\n\nInstantly commit you changes by answering a few short prompts.\n\n```console\n$ gitta -c\n\n? Select an emoji (Use arrow keys or type to search)\n\u003e ✨ :sparkles: - Adding a new feature to the code.\n  🐛 :bug: - Fixed bug in code.\n  📒 :ledger: - Updated documentation for project.\n  🍸 :cocktail: - Updated code formatting and styling.\n  🎨 :art: - Refactoring code in project.\n  ✅ :white_check_mark: - Adding or updating tests.\n  🔧 :wrench: - Fixing unreported issue in code.\n(Move up and down to reveal more choices)\n? Select an emoji 🎨 :art: - Refactoring code in project.\n\n? Specify file(s) updated constant.ts\n? Set commit title Inherit name and version from package.json\n? Set commit message (optional)\n[master 017b307] :art: refactor(constant.ts): Inherit name and version from package.json 1 file changed, 2 insertions(+), 2 deletions(-)\n```\n\n### `gitta -e/--edit`\n\nOpen directory of emoji and prefixes files for editing.\n\n```console\n$ gitta -e\n\nOpening emoji/prefix directory...\n```\n\n### `gitta -h/--help`\n\nDisplay help message.\n\n```console\n   💎 Personalized git commit messages.\n\n  Usage\n      $ gitta -[cehlrsuv]\n\n  Options\n      --commit, -c        An interactive prompt that handles committing your changes.\n      --edit, -e          Edit stored emoji/prefix files.\n      --help, -h          Display help message.\n      --list, -l          List your configured gitta emojis/prefixes.\n      --reconfig, -r      Reconfigure gitta settings.\n      --search, -s        Search for emoji given keywords.\n      --update, -u        Refresh list of emojis/prefixes (does not overwrite custom).\n      --version, -v       Display version of gitta.\n\n  Examples\n      gitta -l\n```\n\n### `gitta -l/--list`\n\nList configured (default + custom) emojis and prefixes for gitta.\n\n*List emojis*\n\n```console\n$ gitta -l\n\n? What data do you want to list out? (Use arrow keys)\n\u003e emojis\n  prefixes\n\n? What data do you want to list out? emojis\n✨ :sparkles: (feat) - Adding a new feature to the code.\n🐛 :bug: (fix) - Fixed bug in code.\n📒 :ledger: (docs) - Updated documentation for project.\n🍸 :cocktail: (style) - Updated code formatting and styling.\n...\n```\n\n*List prefixes*\n\n```console\n$ gitta -l\n\n? What data do you want to list out? (Use arrow keys)\n  emojis\n\u003e prefixes\n\n? What data do you want to list out? prefixes\nfeat (Feature) - Adding new feature to existing project.\nbug (Bug Fix) - Fixing existing bugs.\nchore (Chore) - Something that just had to be done.\ndocs (Documentation) - Adding documentation to project.\n...\n```\n\n### `gitta -r/--reconfig`\n\nReconfigure gitta settings.\n\n```console\n$ gitta -r\n\n? Automatically add all files to your commit. (Y/n) Y\n? Choose how your emojis should be displayed. (Use arrow keys)\n\u003e :tada:\n  🎉\n\n? Choose how your emojis should be displayed. :tada:\n? Set if commits should be signed by default. (Y/n) Y\n? Set if Conventional Commits standard should be used (specify files affected by commit). (Y/n) Y\n? Set Gitta emoji refresh url. (https://raw.githubusercontent.com/Spiderpig86/gitta/master/configuration/emojis.json)\n? Set Gitta prefix refresh url. (https://raw.githubusercontent.com/Spiderpig86/gitta/master/configuration/prefixes.json)\n```\n\n### `gitta -s/--search`\n\nInteractive search for emojis.\n\n```console\n$ gitta -s\n\n? Search for emoji:  (Use arrow keys or type to search)\n\u003e ✨ :sparkles: (feat) - Adding a new feature to the code.\n  🐛 :bug: (fix) - Fixed bug in code.\n  📒 :ledger: (docs) - Updated documentation for project.\n  🍸 :cocktail: (style) - Updated code formatting and styling.\n  🎨 :art: (refactor) - Refactoring code in project.\n  ✅ :white_check_mark: (test) - Adding or updating tests.\n  🔧 :wrench: (chore) - Fixing unreported issue in code.\n(Move up and down to reveal more choices)\n```\n\n### `gitta -u/--update`\n\nUpdate emojis/prefixes from source specified in your configuration.\n\n```console\n$ gitta -u\n\n✔ Succeeded fetching prefixes!\n✔ Succeeded fetching emojis!\n```\n\n### `gitta -v/--version`\n\nGet verison of gitta.\n\n```console\n$ gitta -v\n\n0.0.1\n```\n\n## ⚙ Configuration\n\ngitta can be configured in 2 places:\n\n- `~/.gitta` - stores emoji and prefix files.\n- `~/gitta-nodejs\\Config\\config.json` - settings handled by [Conf](https://www.npmjs.com/package/conf) when you configre with `gitta -r`. Note that the path is `AppData\\Roaming\\` for Windows.\n\nYou can actually add your own emojis and prefixes. All you need to do is add it to the `custom` sections. These will never be overwritten when using `gitta -u`.\n\n*Emojis*\n\n```\n{\n    \"default\": [\n        {\n            \"emoji\": \"✨\",\n            \"code\": \":sparkles:\",\n            \"type\": \"feat\",\n            \"name\": \"sparkles\",\n            \"description\": \"Adding a new feature to the code.\"\n        }\n    ],\n    \"custom\": []\n}\n```\n\n*Prefixes*\n\n```\n{\n    \"default\": [\n        {\n            \"name\": \"Feature\",\n            \"description\": \"Adding new feature to existing project.\",\n            \"prefix\": \"feat\"\n        }\n    ],\n    \"custom\": []\n}\n```\n\n### Default Emojis\n\n| emoji | code                          | type     | description                          |\n|-------|-------------------------------|----------|--------------------------------------|\n| ✨    | `:sparkles:`                  | feat     | Adding a new feature to the code.    |\n| 🐛    | `:bug:`                       | fix      | Fixed bug in code.                   |\n| 📒    | `:ledger:`                    | docs     | Updated documentation for project.   |\n| 🍸    | `:cocktail:`                  | style    | Updated code formatting and styling. |\n| 🎨    | `:art:`                       | refactor | Refactoring code in project.         |\n| ✅     | `:white_check_mark:`          | test     | Adding or updating tests.            |\n| 🔧    | `:wrench:`                    | chore    | Fixing unreported issue in code.     |\n| 🚀    | `:rocket:`                    | chore    | Perfoming deployment for code.       |\n| 🔒    | `:lock:`                      | chore    | Fixing security issues.              |\n| 🚧    | `:construction:`              | feat     | Work in progress.                    |\n| ⬆️    | `:arrow_up:`                  | chore    | Upgrading dependecies.               |\n| ➕     | `:heavy_plus_sign:`           | chore    | Adding a dependency.                 |\n| ➖     | `:heavy_minus_sign:`          | chore    | Removing a dependency.               |\n| ⏪     | `:rewind:`                    | chore    | Reverting changes.                   |\n| 🔀    | `:twisted_rightwards_arrows:` | chore    | Merging branches.                    |\n| ❗️    | `:heavy_exclamation_mark:`    | feat     | Adding breaking changes.             |\n| 🏷️   | `:label:`                     | chore    | Updating type definitions.           |\n| 🗑️   | `:wastebasket:`               | chore    | Remove deprecated code.              |\n| 🎉    | `:tada:`                      | feat     | Initial commit.                      |\n| ⚡️    | `:zap:`                       | feat     | Performance improvement.                      |\n| 🆘    | `:sos:`                      | chore     | Critical hotfix.                      |\n| ⬇️    | `:arrow_down:`                      | chore     | Downgrading dependecies.                      |\n| 💚    | `:green_heart:`                      | chore     | Fix CI build.                      |\n| 🌇    | `:city_sunrise:`                      | chore     | Infrastructure changes.                      |\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fspiderpig86%2Fgitta","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fspiderpig86%2Fgitta","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fspiderpig86%2Fgitta/lists"}