Sandbox
@wellwelwel/lagune

Security workflow harness for agent coding

Lagune adds a security process around your agent work instead of acting as a one-off scanner. It gives you commands like `/lagune.charter`, `/lagune.detect`, `/lagune.plan`, `/lagune.harden`, and `/lagune.verify` so the agent can map risks, propose fixes, apply them safely, and check the result.

148 starsβ€’2 forksβ€’TypeScriptβ€’Updated 17d ago
Who it's for

Builders who want their coding agent to find risks, follow project security rules, and harden changes in a repeatable flow.

What it delivers

You can turn security review into a guided, repeatable part of building, instead of a separate cleanup pass.

What it does

Security charter

Defines project-specific security rules with `/lagune.charter` before the agent starts changing code.

Detect, plan, harden, verify flow

Runs `/lagune.detect`, `/lagune.plan`, `/lagune.harden`, and `/lagune.verify` in order to move from findings to fixes.

Specialized security skills

Creates new sub-skills from articles, exploits, or topics with `/lagune.specialize`.

Proof generation

Turns findings into runnable proofs with `/lagune.prove` for responsible disclosure work.

Local dashboard

Serves a browser dashboard with install, pull, update, and manage actions using `npx -y lagune@latest`.

Multi-agent support

Works with many supported agents and editor setups, with project files for Claude Code, Cursor, Copilot, Windsurf, and Gemini.

How to get it

  1. 1Run
    npx -y lagune@latest init

README

🌊 Lagune AI

Secured By Lagune Version No API Key Needed

Lagune helps your AI agent make a project more secure. You point it at your code, and the agent figures out what your system actually does, then guides you through the security work that matters for it.

  • Lagune works with projects in any programming language and supports 72 agents ✨

Love Lagune? Give us a ⭐ on GitHub!


Table of Contents


Get Started

Lagune adapts to your environment, whether it is a new project or an existing one.

[!TIP]

See real-world Prompt Samples πŸͺΌ


Dashboard

For an interactive live view, follow-up, and maintenance, run:

npx -y lagune@latest

It serves a dashboard and opens it in a random port:

  • Live Reload
  • Private and Local
  • Install, Pull, Update, and Manage all Lagune features directly from your browser
  • No node_modules or package.json is needed πŸ“¦
Overview

[!TIP]

  • πŸšͺ Use --port or -p to specify a custom port.
  • ⏏️ Press Ctrl+C to stop.

CLI

β€Ί Install

npx -y lagune@latest init
  • πŸƒ Lagune runs on Node.js under the hood, you use whatever language you want.

β€Ί Update

To update Lagune's own files and its commands to their latest versions, run:

npx -y lagune@latest update

[!TIP]

Your charter, the phase artifacts, and any custom specializations stay untouched.

β€Ί Pull

When you clone or fork a project that already has Lagune, run pull to install its files from the manifest:

npx -y lagune@latest pull

[!TIP]

πŸ’‘ Think of it as the Lagune equivalent of npm i, pip install -r requirements.txt, and the like.


Slash Commands

Once Lagune is set up in your project, your AI agent unlocks a set of slash commands:

β€Ί Development flow

Harden the work as you build it, guided by the charter, with no flow to follow:

CommandWhat it does for you
/laguneEnforces security along with your development, on any prompt, at any time
  • Pull in the on-demand specializations in real time while your agent works.
  • Combine it with the /lagune.charter command to shape every build around your project's own security rules.

β€Ί The Blue Team flow

These five run in order. Each builds on the previous, so following the list top to bottom is all it takes:

#CommandWhat it does for you
1/lagune.charterSets your project's security rules, proposed for you or shaped by what you say
2/lagune.detectReads your code and maps what your system does and where the risks are
3/lagune.planTurns what detect found into a defense plan, with a fix for each finding
4/lagune.hardenApplies the plan's fixes to your code, safely and one at a time
5/lagune.verifyProves each applied fix holds and closes out the ones that do

β€Ί Special commands

CommandWhat it does
/lagune.specializeSpecializes Lagune in a new security sub-skill from articles, exploits, or topics
/lagune.proveTurns each detected finding into a runnable proof for responsible disclosure

[!TIP]

Security is not a cost, it is an investment: what you put in upfront, you save many times over in the incidents you never have πŸ™‹πŸ»β€β™‚οΈ

[!IMPORTANT]

See the full documentation for usage examples and more.


Requirements

You will need these tools installed on your system:


Security

To details, report a vulnerability, and see the supported versions, see the Security Policy.


Contributing

See the Contributing Guide and please follow our Code of Conduct πŸš€


Acknowledgements

Partners

Partners get an exclusive logo across the repositories and landing pages, plus a spot on a dedicated partners page.

Help my work grow by becoming a partner πŸ––

Supporters

Really thanks to everyone who has supported and keeps supporting my work.

Sponsors

Support my work by becoming a sponsor too ✨


License

Lagune is under the MIT License.
Copyright Β© 2026-present Weslley AraΓΊjo and contributors.

[!IMPORTANT]

Disclaimer

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

Files in the repo

Repository payloadβ€’31 top-level entries
  • .claude
  • .github
  • .vscode
  • scripts
  • spec
  • src
  • test
  • tools
  • website
  • .cursorrules
  • .editorconfig
  • .gitattributes
  • .gitignore
  • .npmrc
  • .pokurc.json
  • .prettierignore
  • .prettierrc
  • .windsurfrules
  • AGENTS.md
  • CHANGELOG.md
  • CLAUDE.md
  • CODE_OF_CONDUCT.md
  • CONTRIBUTING.md
  • deno.json
  • GEMINI.md
  • LICENSE
  • package-lock.json
  • package.json
  • README.md
  • SECURITY.md
  • tsconfig.json

Discussion (0)

Ask about usage, or say what you built with it

Sign in to join the discussion.

No comments yet. Be the first to say what this is good for.

More harnesses

affaan-m/
ECC
affaan-m/ECCHarnesses

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

258k
ruvnet/rufloHarnesses

🌊 The original agent meta-harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, RAG integration, and native Claude Code / Codex / Hermes and many more Integrated

72k

Practical patterns, starters & CLI tools for loop engineering with AI coding agents. Design systems that prompt and orchestrate agents (inspired by Addy Osmani and Boris Cherny). Includes loop-audit, loop-init, loop-cost.

11k