diff --git a/.github/workflows/attest-docs.yml b/.github/workflows/attest-docs.yml new file mode 100644 index 0000000..f0f4a0b --- /dev/null +++ b/.github/workflows/attest-docs.yml @@ -0,0 +1,34 @@ +name: Attest CLI Documentation + +on: + push: + branches: [main] + paths: + - '*.md' + - 'LICENSE' + - 'CONTRIBUTING.md' + workflow_dispatch: + +permissions: + contents: read + id-token: write + attestations: write + +jobs: + attest-docs: + name: Attest GitKraken CLI Docs + runs-on: ubuntu-latest + + steps: + - name: Checkout repository + uses: actions/checkout@v4 + + - name: Attest documentation files + uses: actions/attest-build-provenance@v2 + with: + subject-path: | + README.md + keller-branding-report.md + keller-branding-report-puro.md + LICENSE + CONTRIBUTING.md diff --git a/README.md b/README.md index ec53c1c..f11c1cf 100644 --- a/README.md +++ b/README.md @@ -1,22 +1,36 @@ -# 🚀 GitKraken CLI +# � Reportes de Branding + +Este repositorio incluye dos reportes de branding con todos los tópicos y campos originales definidos por el autor: + +- [`keller-branding-report.md`](./keller-branding-report.md): Versión visual avanzada (ideal para portafolios, presentaciones y GitHub). +- [`keller-branding-report-puro.md`](./keller-branding-report-puro.md): Versión Markdown puro (máxima compatibilidad y sin HTML). + +Ambos archivos están disponibles en el repositorio y en la carpeta Descargas del autor. +# �🚀 GitKraken CLI `gk` is GitKraken on the command line. The core functionality is focused on "Work Items" which can be thought of as the feature or issue you are trying to tackle. This allows you to work with multiple repos at once and get the same UX as if you were in a monorepo. We also provide robust AI-powered commit messages and Pull Request generation. It also provides an MCP server that streamlines working with git and your Issue and git hosting providers. GitKraken CLI is available on macOS, Windows, and Unix systems. -![](./images/cli-header-wide.png) +![GitKraken CLI header](./images/cli-header-wide.png) ## Table of Contents -- [MCP Server](#mcp-server) -- [Documentation](#documentation) -- [Workflows](#workflows) -- [`git` Command Passthrough](#git-command-passthrough) -- [Installation](#installation) -- [Troubleshooting](#troubleshooting) -- [Support](#support) - -## MCP Server +- [🚀 gk-cli: Gestión inteligente de repositorios multi-proveedor](#-gk-cli-gestión-inteligente-de-repositorios-multi-proveedor) +- [🚀 GitKraken CLI](#-gitkraken-cli) + - [Table of Contents](#table-of-contents) + - [Documentation](#documentation) + - [`git` Command Passthrough](#git-command-passthrough) + - [Installation](#installation) + - [macOS](#macos) + - [Unix / Ubuntu](#unix--ubuntu) + - [Windows](#windows) + - [⚙️ Configuration](#️-configuration) + - [Nerd Fonts](#nerd-fonts) + - [Troubleshooting](#troubleshooting) + - [`gk login` freezes after authenticating in browser](#gk-login-freezes-after-authenticating-in-browser) + - [gk from Oh-My-Zsh](#gk-from-oh-my-zsh) + - [Manual macOS Installation](#manual-macos-installation) The GitKraken MCP server is a local MCP server that is powerful and easy to use. It wraps git, GitHub, Jira MCP actions as well as provides tools to LLMs that work with GitKraken APIs and functionality. You can find specific installation instructions based on your chosen AI application in the [Help Center](https://help.gitkraken.com/cli/gk-cli-mcp/). @@ -24,7 +38,7 @@ If you want to read more about the MCP server, you can check out the [introducti ## Documentation -`gk help` is going to be your best source for exploring the CLI. But also see the [workflows](#workflows) below. +`gk help` is going to be your best source for exploring the CLI. But also see the [Workflows](#workflows) section below. ```bash Welcome to GitKraken CLI, a premium CLI experience for managing multiple repositories with familiar GIT CLI commands @@ -53,7 +67,7 @@ Flags: -h, --help help for gk Use "gk [command] --help" for more information about a command. -``` +```markdown ## Workflows @@ -80,12 +94,13 @@ gk work create "My new work item" gk work commit --ai # Push your changes -gk work push +
+ Logo Keller +
-# Create a Pull Request -gk work pr create --ai - -``` +
+ Letrero Keller +
Once you have familiarized yourself with using a single repo, try out creating work items and generating commits and PRs for multiple repos at a time by just adding multiple repos to a new Work Item. @@ -168,7 +183,7 @@ winget install gitkraken.cli ### Nerd Fonts -The GitKraken CLI supports Nerd Fonts to display icons for some commands. To ensure correct icon rendering, please obtain and install a Nerd Font available at https://www.nerdfonts.com/. After installation, set the selected Nerd Font as the default font for your terminal. +The GitKraken CLI supports Nerd Fonts to display icons for some commands. To ensure correct icon rendering, please obtain and install a Nerd Font available at [https://www.nerdfonts.com/](https://www.nerdfonts.com/). After installation, set the selected Nerd Font as the default font for your terminal. ## Troubleshooting @@ -180,6 +195,7 @@ This problem is due to the browser. Currently we know that Safari and Brave do n Oh-My-Zsh has `gitk` aliased as `gk` and that can create some problems. To fix this, type in your terminal: +```markdown ``` unalias gk ``` @@ -188,12 +204,52 @@ unalias gk If you install the CLI manually from the releases page on macOS, you will likely run into a security error that looks like this: -![](./images/not-opened.png) +![macOS security error dialog](./images/not-opened.png) To fix this, go to Settings > Security & Privacy > General and click "Allow Anyway". -![](./images/allow-anyway.png) +![macOS Security & Privacy "Allow Anyway" button screenshot](./images/allow-anyway.png) Try running `gk setup` again and then click "Open Anyway" to continue. -![](./images/open-anyway.png) +![macOS "Open Anyway" dialog screenshot](./images/open-anyway.png) + +[releases page]: https://github.com/gitkraken/gk-cli/releases +[winget]: https://learn.microsoft.com/en-us/windows/package-manager/winget/ + +--- +## Branding & Autor + +**KELLER_NICKNAME_ARTIST:** "•K e l £ ə r•" 🛸 +**KELLER_ALTER_EGO:** "Extraterrestrial ▲ ET" +**KELLER_NAME:** "Oscar Rojas Ortiz | ORO" +**KELLER_SOCIAL:** Instagram [@kelleretoro](https://instagram.com/kelleretoro) | Facebook [kelleretoroph](https://facebook.com/kelleretoroph) +**KELLER_HASHTAGS:** #KellerOjo #kellerETojo #kellerEToro +**KELLER_PALLETS:** #8dffe9, #4bfbd6, #283431, #01f8fe, #2a302b +**KELLER_LICENSE:** +- BSD 3-Clause (software) +- CC BY-ND 4.0 (imágenes, logos y colores) +[Ver licencia completa](./LICENSE) +**KELLER_KEYWORDS:** kelleretoro, keller, kel£ǝr, trends, google, photo, foto, fotografía, México + +--- + + +### CONTACTO +- **KELLER MAIL:** rojort.os@kelleretoro.com +- **KELLER PHONE:** +52 5532298221 +- **KELLER_SOCIAL_NETWORKS:** Instagram [@kelleretoro](https://instagram.com/kelleretoro) | Facebook [kelleretoroph](https://facebook.com/kelleretoroph) | Blogspot [kellershots.blogspot.com](https://kellershots.blogspot.com/) + +--- + +Fundé Keller en 2017 como un Stock Fotográfico que captura la esencia de los lugares en México que visito. Gracias a ustedes, mis seguidores, cada vez llego a más personas a través de las plataformas digitales donde tengo presencia. La pasión compartida hacia la fotografía profesional, junto con mis clientes, me permite seguir creciendo y expandiéndome. + + +
+ Logo Keller +
+ +
+ Letrero Keller +
+🚀 Testing release attestations - miércoles, 6 de agosto de 2025, 21:09:13 CST diff --git a/keller-branding-report-puro.md b/keller-branding-report-puro.md new file mode 100644 index 0000000..c3417bc --- /dev/null +++ b/keller-branding-report-puro.md @@ -0,0 +1,73 @@ +# 📒 Informe de Branding Keller (Markdown Puro) + +> **Nota:** Esta versión es 100% Markdown puro, máxima compatibilidad y sin HTML. Ideal para linters y plataformas estrictas. + +--- + +## LOGOS + +![KELLER_LOGO](https://raw.githubusercontent.com/Kelleretoro/ssh-log-cli/main/assets/logo.png) + +![KELLER_LETRERO](https://raw.githubusercontent.com/Kelleretoro/ssh-log-cli/main/assets/letrero.jpg) + +--- + +## Branding & Autor + +- 🖌️ **KELLER_NICKNAME_ARTIST:** "•K e l £ ə r•" +- 👽 **KELLER_ALTER_EGO:** "Extraterrestrial ▲ ET" +- 🧑‍🚀 **KELLER_NAME:** "Oscar Rojas Ortiz | ORO" + +--- + +## KELLER_SOCIAL + +- Instagram: [@kelleretoro](https://instagram.com/kelleretoro) +- Facebook: [kelleretoroph](https://facebook.com/kelleretoroph) + +--- + +## KELLER_HASHTAGS + +- #KellerOjo +- #kellerETojo +- #kellerEToro + +--- + +## KELLER_PALLETS + +- #8dffe9 +- #4bfbd6 +- #283431 +- #01f8fe +- #2a302b + +--- + +## KELLER_LICENSE + +- BSD 3-Clause (software) +- CC BY-ND 4.0 (imágenes, logos y colores) +- [Ver licencia completa](./LICENSE) + +--- + +## KELLER_KEYWORDS + +kelleretoro, keller, kel£ǝr, trends, google, photo, foto, fotografía, México + +--- + +## CONTACTO + +- ✉️ **KELLER_MAIL:** rojort.os@kelleretoro.com +- 📱 **KELLER_PHONE:** +52 5532298221 + +--- + +## KELLER_SOCIAL_NETWORKS + +- Instagram: [@kelleretoro](https://instagram.com/kelleretoro) +- Facebook: [kelleretoroph](https://facebook.com/kelleretoroph) +- Blogspot: [kellershots.blogspot.com](https://kellershots.blogspot.com/) diff --git a/keller-branding-report.jsonc b/keller-branding-report.jsonc new file mode 100644 index 0000000..51a24c4 --- /dev/null +++ b/keller-branding-report.jsonc @@ -0,0 +1,47 @@ +{ + // Branding & Autor + "KELLER_NICKNAME_ARTIST": "•K e l £ ə r•", + "KELLER_ALTER_EGO": "Extraterrestrial ▲ ET", + "KELLER_NAME": "Oscar Rojas Ortiz | ORO", + "KELLER_SOCIAL": [ + "Instagram: @kelleretoro (https://instagram.com/kelleretoro)", + "Facebook: kelleretoroph (https://facebook.com/kelleretoroph)" + ], + "KELLER_HASHTAGS": [ + "#KellerOjo", + "#kellerETojo", + "#kellerEToro" + ], + "KELLER_PALLETS": [ + "#8dffe9", + "#4bfbd6", + "#283431", + "#01f8fe", + "#2a302b" + ], + "KELLER_LICENSE": [ + "BSD 3-Clause (software)", + "CC BY-ND 4.0 (imágenes, logos y colores)" + ], + "KELLER_LICENSE_LINK": "./LICENSE", + "KELLER_KEYWORDS": [ + "kelleretoro", "keller", "kel£ǝr", "trends", "google", "photo", "foto", "fotografía", "México" + ], + + // Contacto + "CONTACTO": { + "KELLER_MAIL": "rojort.os@kelleretoro.com", + "KELLER_PHONE": "+52 5532298221", + "KELLER_SOCIAL_NETWORKS": [ + "Instagram: @kelleretoro (https://instagram.com/kelleretoro)", + "Facebook: kelleretoroph (https://facebook.com/kelleretoroph)", + "Blogspot: kellershots.blogspot.com (https://kellershots.blogspot.com/)" + ] + }, + + // Logos + "LOGOS": [ + "https://raw.githubusercontent.com/Kelleretoro/ssh-log-cli/main/assets/logo.png", + "https://raw.githubusercontent.com/Kelleretoro/ssh-log-cli/main/assets/letrero.jpg" + ] +} diff --git a/keller-branding-report.md b/keller-branding-report.md new file mode 100644 index 0000000..310e95a --- /dev/null +++ b/keller-branding-report.md @@ -0,0 +1,79 @@ + + +# 📒 Informe de Branding Keller + +> **Nota:** Esta versión utiliza HTML para una presentación visual avanzada. Ideal para portafolios, presentaciones y GitHub. + +--- + +## LOGOS + +
+ KELLER_LOGO +
+ +
+ KELLER_LETRERO +
+ +--- + +## Branding & Autor + +- 🖌️ **KELLER_NICKNAME_ARTIST:** "•K e l £ ə r•" +- 👽 **KELLER_ALTER_EGO:** "Extraterrestrial ▲ ET" +- 🧑‍🚀 **KELLER_NAME:** "Oscar Rojas Ortiz | ORO" + +--- + +## KELLER_SOCIAL + +- Instagram: [@kelleretoro](https://instagram.com/kelleretoro) +- Facebook: [kelleretoroph](https://facebook.com/kelleretoroph) + +--- + +## KELLER_HASHTAGS + +- #KellerOjo +- #kellerETojo +- #kellerEToro + +--- + +## KELLER_PALLETS + +- #8dffe9 +- #4bfbd6 +- #283431 +- #01f8fe +- #2a302b + +--- + +## KELLER_LICENSE + +- BSD 3-Clause (software) +- CC BY-ND 4.0 (imágenes, logos y colores) +- [Ver licencia completa](./LICENSE) + +--- + +## KELLER_KEYWORDS + +kelleretoro, keller, kel£ǝr, trends, google, photo, foto, fotografía, México + +--- + +## CONTACTO + +- ✉️ **KELLER_MAIL:** rojort.os@kelleretoro.com +- 📱 **KELLER_PHONE:** +52 5532298221 + +--- + +## KELLER_SOCIAL_NETWORKS + +- Instagram: [@kelleretoro](https://instagram.com/kelleretoro) +- Facebook: [kelleretoroph](https://facebook.com/kelleretoroph) +- Blogspot: [kellershots.blogspot.com](https://kellershots.blogspot.com/)