Skip to content

docs: fix cli token command for token resolution#9077

Merged
jdx merged 1 commit intojdx:mainfrom
roele:fix/docs-cli-token
Apr 15, 2026
Merged

docs: fix cli token command for token resolution#9077
jdx merged 1 commit intojdx:mainfrom
roele:fix/docs-cli-token

Conversation

@roele
Copy link
Copy Markdown
Contributor

@roele roele commented Apr 13, 2026

Fixes the mise token [forgejo | github | gitlab] commands in the respective docs.

Copilot AI review requested due to automatic review settings April 13, 2026 22:01
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Updates developer documentation to reflect the correct mise token <provider> CLI syntax for inspecting which auth token mise will use for a host.

Changes:

  • Replace outdated mise <provider> token examples with mise token <provider> for GitHub, GitLab, and Forgejo docs.
  • Add a brief explanatory line in GitLab/Forgejo backend docs matching the GitHub doc’s “Debugging token resolution” guidance.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated no comments.

File Description
docs/dev-tools/github-tokens.md Updates token debugging examples to mise token github ... to match current CLI.
docs/dev-tools/backends/gitlab.md Updates token debugging section to mise token gitlab ... and adds clarifying sentence.
docs/dev-tools/backends/forgejo.md Updates token debugging section to mise token forgejo ... and adds clarifying sentence.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@greptile-apps
Copy link
Copy Markdown
Contributor

greptile-apps Bot commented Apr 13, 2026

Greptile Summary

This PR fixes three documentation files to use the correct mise token [provider] command syntax instead of the incorrect mise [provider] token format. The fix is confirmed correct by the CLI source code in src/cli/token/mod.rs, which defines token as the top-level command with forgejo, github, and gitlab as subcommands. It also adds a brief introductory sentence to the Forgejo and GitLab debugging sections (matching the existing GitHub tokens doc).

Confidence Score: 5/5

Safe to merge — documentation-only fix with no logic changes.

All three files correct the command syntax to match the actual CLI structure (mise token [provider] as confirmed in src/cli/token/mod.rs). No code is changed; there are no logic, security, or correctness concerns.

No files require special attention.

Important Files Changed

Filename Overview
docs/dev-tools/backends/forgejo.md Corrects mise forgejo tokenmise token forgejo in the debugging section and adds an intro sentence; change matches the actual CLI structure.
docs/dev-tools/backends/gitlab.md Corrects mise gitlab tokenmise token gitlab in the debugging section and adds an intro sentence; change matches the actual CLI structure.
docs/dev-tools/github-tokens.md Corrects mise github tokenmise token github in the Debugging Token Resolution section; aligns with the canonical CLI command registered in src/cli/token/.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A["mise token <provider>"] --> B{Provider subcommand}
    B --> C["forgejo\n(src/cli/token/forgejo.rs)"]
    B --> D["github\n(src/cli/token/github.rs)"]
    B --> E["gitlab\n(src/cli/token/gitlab.rs)"]
    C --> F[Resolve Forgejo token for host]
    D --> G[Resolve GitHub token for host]
    E --> H[Resolve GitLab token for host]
    F --> I["Print: host: <masked|full token> (source: ...)"]
    G --> I
    H --> I
Loading

Reviews (1): Last reviewed commit: "docs: fix cli token command for token re..." | Re-trigger Greptile

Copy link
Copy Markdown
Contributor

@gemini-code-assist gemini-code-assist Bot left a comment

Choose a reason for hiding this comment

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

Code Review

This pull request updates the documentation for Forgejo, GitLab, and GitHub backends to reflect a change in the CLI command structure for token resolution, transitioning from mise <backend> token to mise token <backend>. I have no feedback to provide as there are no review comments.

@jdx jdx merged commit ec4c1e2 into jdx:main Apr 15, 2026
39 of 40 checks passed
@roele roele deleted the fix/docs-cli-token branch April 15, 2026 05:30
mise-en-dev added a commit that referenced this pull request Apr 15, 2026
### 🚀 Features

- **(npm)** use --min-release-age for npm 11.10.0+ supply chain
protection by @webkaz in [#9072](#9072)
- **(registry)** add openfga by @mnm364 in
[#9084](#9084)
- **(task)** allow to set confirmation default by @roele in
[#9089](#9089)
- support os/arch compound syntax in tool os filtering by @RobertDeRose
in [#9088](#9088)

### 🐛 Bug Fixes

- **(activate)** export __MISE_EXE and resolve bare ARGV0 to absolute
path by @fru1tworld in [#9081](#9081)
- **(install)** support aliased installs sharing a backend by @jdx in
[#9093](#9093)
- **(shim)** use which_no_shims when resolving mise binary in reshim and
doctor by @kevinswiber in [#9071](#9071)
- filter empty segments in colon-separated env var parsing by @baby-joel
in [#9076](#9076)

### 📚 Documentation

- fix wrong file reference to forgejo backend implemenation by @roele in
[#9090](#9090)
- fix cli token command for token resolution by @roele in
[#9077](#9077)

### 📦 Registry

- add trzsz-go
([aqua:trzsz/trzsz-go](https://github.com/trzsz/trzsz-go)) by
@ZeroAurora in [#9083](#9083)
- add copilot
([aqua:github/copilot-cli](https://github.com/github/copilot-cli)) by
@risu729 in [#9082](#9082)

### Chore

- add AGENTS.md symlink by @jdx in
[#9094](#9094)

### New Contributors

- @kevinswiber made their first contribution in
[#9071](#9071)
- @webkaz made their first contribution in
[#9072](#9072)
- @RobertDeRose made their first contribution in
[#9088](#9088)

## 📦 Aqua Registry Updates

#### New Packages (7)

-
[`IBM-Cloud/ibm-cloud-cli-release`](https://github.com/IBM-Cloud/ibm-cloud-cli-release)
- [`max-sixty/worktrunk`](https://github.com/max-sixty/worktrunk)
- [`micelio.dev/hif`](https://github.com/micelio.dev/hif)
- [`pgplex/pgschema`](https://github.com/pgplex/pgschema)
-
[`rose-pine/rose-pine-bloom`](https://github.com/rose-pine/rose-pine-bloom)
- [`santosr2/TerraTidy`](https://github.com/santosr2/TerraTidy)
- [`trzsz/trzsz-go`](https://github.com/trzsz/trzsz-go)

#### Updated Packages (3)

- [`mvdan/sh`](https://github.com/mvdan/sh)
- [`rvben/rumdl`](https://github.com/rvben/rumdl)
- [`temporalio/temporal`](https://github.com/temporalio/temporal)
netbsd-srcmastr pushed a commit to NetBSD/pkgsrc that referenced this pull request Apr 16, 2026
## [2026.4.14](https://github.com/jdx/mise/compare/v2026.4.13..v2026.4.14) - 2026-04-15

### Chore

- bump sigstore-verification by @jdx in [#9128](jdx/mise#9128)

## [2026.4.13](https://github.com/jdx/mise/compare/v2026.4.12..v2026.4.13) - 2026-04-15

### 🐛 Bug Fixes

- **(go)** honor install_before for module versions by @mariusvniekerk in [#9097](jdx/mise#9097)
- **(vfox-plugin)** support Git URL with commit hash for mise.toml by @Oyami-Srk in [#9099](jdx/mise#9099)
- `MISE_FETCH_REMOTE_VERSIONS_CACHE` not respected by @mcncl in [#9096](jdx/mise#9096)

### 📦️ Dependency Updates

- unblock cargo-deny advisories check by @jdx in [#9112](jdx/mise#9112)

### New Contributors

- @mariusvniekerk made their first contribution in [#9097](jdx/mise#9097)
- @mcncl made their first contribution in [#9096](jdx/mise#9096)
- @Oyami-Srk made their first contribution in [#9099](jdx/mise#9099)

## [2026.4.12](https://github.com/jdx/mise/compare/v2026.4.11..v2026.4.12) - 2026-04-15

### 🚀 Features

- **(npm)** use --min-release-age for npm 11.10.0+ supply chain protection by @webkaz in [#9072](jdx/mise#9072)
- **(registry)** add openfga by @mnm364 in [#9084](jdx/mise#9084)
- **(task)** allow to set confirmation default by @roele in [#9089](jdx/mise#9089)
- support os/arch compound syntax in tool os filtering by @RobertDeRose in [#9088](jdx/mise#9088)

### 🐛 Bug Fixes

- **(activate)** export __MISE_EXE and resolve bare ARGV0 to absolute path by @fru1tworld in [#9081](jdx/mise#9081)
- **(install)** support aliased installs sharing a backend by @jdx in [#9093](jdx/mise#9093)
- **(shim)** use which_no_shims when resolving mise binary in reshim and doctor by @kevinswiber in [#9071](jdx/mise#9071)
- filter empty segments in colon-separated env var parsing by @baby-joel in [#9076](jdx/mise#9076)

### 📚 Documentation

- fix wrong file reference to forgejo backend implemenation by @roele in [#9090](jdx/mise#9090)
- fix cli token command for token resolution by @roele in [#9077](jdx/mise#9077)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants