Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
34 changes: 34 additions & 0 deletions .github/workflows/attest-docs.yml
Original file line number Diff line number Diff line change
@@ -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
100 changes: 78 additions & 22 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,30 +1,44 @@
# 🚀 GitKraken CLI
# � Reportes de Branding
Copy link

Copilot AI Dec 2, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The character "�" appears to be a mojibake/encoding error. This should likely be an emoji icon like "📒" or another relevant icon.

Suggested change
# Reportes de Branding
# 📒 Reportes de Branding

Copilot uses AI. Check for mistakes.

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
Copy link

Copilot AI Dec 2, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The character "�" appears to be a mojibake/encoding error. This should likely be the same emoji icon that appears in the first heading or removed entirely.

Copilot uses AI. Check for mistakes.

`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/).

If you want to read more about the MCP server, you can check out the [introduction blog post](https://www.gitkraken.com/blog/introducing-gitkraken-mcp)

## 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
Expand Down Expand Up @@ -53,7 +67,7 @@ Flags:
-h, --help help for gk

Use "gk [command] --help" for more information about a command.
```
```markdown
Copy link

Copilot AI Dec 2, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Incorrect code fence language. This should be an empty string or "bash" instead of "markdown" since the content is a command line example, not markdown code.

Suggested change
```markdown
```bash

Copilot uses AI. Check for mistakes.

## Workflows

Expand All @@ -80,12 +94,13 @@ gk work create "My new work item"
gk work commit --ai

# Push your changes
gk work push
<div align="center">
<img alt="Logo Keller" src="https://raw.githubusercontent.com/Kelleretoro/ssh-log-cli/main/assets/logo.png" width="220"/>
</div>

# Create a Pull Request
gk work pr create --ai

```
<div align="center">
<img alt="Letrero Keller" src="https://raw.githubusercontent.com/Kelleretoro/ssh-log-cli/main/assets/letrero.jpg" width="320"/>
</div>
Comment on lines +97 to +103
Copy link

Copilot AI Dec 2, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This section appears to have been corrupted. Lines 97-103 contain HTML image tags in the middle of the "Workflows" section, replacing what should be workflow commands (gk work push, gk work pr create --ai, and the closing code fence). This breaks the code example and is not semantically appropriate here. The workflow example is now incomplete and malformed.

Copilot uses AI. Check for mistakes.

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.

Expand Down Expand Up @@ -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

Expand All @@ -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
```
Comment on lines +198 to 199
Copy link

Copilot AI Dec 2, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Incorrect code fence language. This should be "bash" or "sh" instead of "markdown" since this is a shell command.

Suggested change
```markdown
```
```bash

Copilot uses AI. Check for mistakes.
unalias gk
```
Expand All @@ -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
Copy link

Copilot AI Dec 2, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Spelling error: "KELLER_PALLETS" should be "KELLER_PALETTES". A pallet is a wooden platform for shipping goods, while a palette is a range of colors used in design.

Suggested change
**KELLER_PALLETS:** #8dffe9, #4bfbd6, #283431, #01f8fe, #2a302b
**KELLER_PALETTES:** #8dffe9, #4bfbd6, #283431, #01f8fe, #2a302b

Copilot uses AI. Check for mistakes.
**KELLER_LICENSE:**
- BSD 3-Clause (software)
- CC BY-ND 4.0 (imágenes, logos y colores)
[Ver licencia completa](./LICENSE)
Copy link

Copilot AI Dec 2, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Missing line break before the LICENSE section. Line 232 should have a blank line after it before line 233 to properly separate the LICENSE information from the KEYWORDS field.

Suggested change
[Ver licencia completa](./LICENSE)
[Ver licencia completa](./LICENSE)

Copilot uses AI. Check for mistakes.
**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.


<div align="center">
<img alt="Logo Keller" src="https://raw.githubusercontent.com/Kelleretoro/ssh-log-cli/main/assets/logo.png" width="220"/>
</div>

<div align="center">
<img alt="Letrero Keller" src="https://raw.githubusercontent.com/Kelleretoro/ssh-log-cli/main/assets/letrero.jpg" width="320"/>
</div>
🚀 Testing release attestations - miércoles, 6 de agosto de 2025, 21:09:13 CST
73 changes: 73 additions & 0 deletions keller-branding-report-puro.md
Original file line number Diff line number Diff line change
@@ -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
Copy link

Copilot AI Dec 2, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Spelling error: "PALLETS" should be "PALETTES". A pallet is a wooden platform for shipping goods, while a palette is a range of colors used in design.

Suggested change
## KELLER_PALLETS
## KELLER_PALETTES

Copilot uses AI. Check for mistakes.

- #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/)
47 changes: 47 additions & 0 deletions keller-branding-report.jsonc
Original file line number Diff line number Diff line change
@@ -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": [
Copy link

Copilot AI Dec 2, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Spelling error: "KELLER_PALLETS" should be "KELLER_PALETTES". A pallet is a wooden platform for shipping goods, while a palette is a range of colors used in design.

Suggested change
"KELLER_PALLETS": [
"KELLER_PALETTES": [

Copilot uses AI. Check for mistakes.
"#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"
]
}
79 changes: 79 additions & 0 deletions keller-branding-report.md
Original file line number Diff line number Diff line change
@@ -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

<div align="center">
<img alt="KELLER_LOGO" src="https://raw.githubusercontent.com/Kelleretoro/ssh-log-cli/main/assets/logo.png" width="180"/>
</div>

<div align="center">
<img alt="KELLER_LETRERO" src="https://raw.githubusercontent.com/Kelleretoro/ssh-log-cli/main/assets/letrero.jpg" width="260"/>
</div>

---

## 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
Copy link

Copilot AI Dec 2, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Spelling error: "PALLETS" should be "PALETTES". A pallet is a wooden platform for shipping goods, while a palette is a range of colors used in design.

Suggested change
## KELLER_PALLETS
## KELLER_PALETTES

Copilot uses AI. Check for mistakes.

- #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/)