readonly-mode

Create a persistent marker file and run a shell script to enable read-only mode.

18|3|Updated Nov 13, 2025
One-click install
npx skills add https://github.com/mystilleef/gemini-cli-modes --skill readonly-mode
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: readonly-mode
Source: https://github.com/mystilleef/gemini-cli-modes/tree/main/skills/readonly-mode
Command: npx skills add https://github.com/mystilleef/gemini-cli-modes --skill readonly-mode

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Enable safe, enforced no-write state by creating a marker that blocks write-capable tools and protects the project from unintended changes.

Core Features & Use Cases

  • Create a persistent marker (.gemini_readonly) to enforce read-only mode across tools and sessions.
  • Quick activation in any workflow to prevent accidental edits during critical tasks.
  • Use when you need to lock a project for auditing, review, or safe collaboration.

Quick Start

Run the enable-readonly-mode.sh script to activate read-only mode.

Frequently Asked Questions about readonly-mode

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I enable read-only mode to protect a live project from accidental modifications?

You can enable read-only mode by running the enable-readonly-mode.sh script, which creates a persistent marker file to block write operations. This marker enforces a safe no-write state across tools and sessions to prevent unintended changes.

What is a marker file and how does it block write operations in a project?

A marker file, specifically named .gemini_readonly, is a persistent file created to enforce read-only mode across tools and sessions. It acts as a signal to block write-capable tools from modifying the live project during critical tasks.

When should I lock a project into a read-only state?

You should lock a project into a read-only state when you need to prevent accidental edits during critical tasks like auditing, code review, or safe collaboration. It creates a persistent marker to ensure no unintended modifications occur.

Does read-only mode persist across different sessions and tools?

Yes, read-only mode persists across sessions and tools by creating a persistent marker file. This ensures that write-capable tools are continuously blocked from making accidental modifications in the live project environment.

Can I use a shell script to prevent accidental edits during code review?

Yes, you can run the enable-readonly-mode.sh shell script to quickly activate read-only mode. This creates a marker file that blocks write operations, protecting your project from unintended changes during reviews or audits.

What is the best way to enforce a no-write state for safe collaboration?

The best way to enforce a no-write state is to create a persistent marker file that blocks write-capable tools. This approach prevents accidental modifications across sessions, ensuring safe collaboration and auditing.