Get Started

Install Lagune on Gemini CLI as an Extension

Install Lagune on Gemini CLI as an extension, keep it updated, and allow its engine up front.

Install the extension from your terminal:

gemini extensions install https://github.com/wellwelwel/lagune

Update​

To update Lagune, run:

gemini extensions update lagune

To keep it updated, install it with --auto-update.

Commands​

Type the commands under the extension's name, such as /lagune:lagune-charter for /lagune-charter.


Permissions

The engine runs through two tools: lagune_read only reads your project, and lagune_write only writes to .lagune/. Gemini CLI starts them only in a trusted folder. To allow them up front, save this rule as ~/.gemini/policies/lagune.toml:

[[rule]]
mcpName = "lagune"
toolName = ["lagune_read", "lagune_write"]
decision = "allow"
priority = 100

When the engine runs through npx, as with the skills.sh, add this rule to the same file:

[[rule]]
toolName = "run_shell_command"
commandRegex = 'npx --yes lagune@\d+\.\d+\.\d+\s'
decision = "allow"
priority = 100

Frequently Asked Questions

Run gemini extensions install https://github.com/wellwelwel/lagune.

Run gemini extensions update lagune, or install the extension with --auto-update.

Type them under the extension's name, such as /lagune:lagune-charter.

Yes. Add a policy rule that allows the lagune server's lagune_read and lagune_write tools, plus one for run_shell_command with npx --yes lagune@ and a version when the engine runs through npx.

Last updated on November 3, 2026.

Copyright © 2026-present Weslley Araújo and contributors. Lagune is under the Apache License 2.0. Please check the Security Policy.

All product names, trademarks, and registered trademarks mentioned are the property of their respective owners and are used for identification purposes only.