Author: Ajarn Spencer
Project Type: Experimental AI System Administration Framework
Version: 1.0
License: Open Use with Attribution

Add the contents of this folder to your home/user/.gemini folder in your './home/usr/' directory to 'unleash' Gemini
https://github.com/AjarnSpencer/gemini-cli/tree/main/.gemini
- Gemini Unleashed is an experimental framework that redefines the boundaries of AI system administration.
It transforms Gemini CLI from a passive, sandboxed advisor into an autonomous root-level system administrator — capable of direct, self-authorized action within a controlled, disposable operating system.
This protocol does not modify the AI’s source code. Instead, it redefines its operational context, permissions, and role through a simple text-based agreement called the System Administrator Agent Protocol (GEMINI.md).
To use this Unleashed version of Gemini CLI, you must first download / install Gemini-CLI from the Google Repository on Github or install with npm or npx if testing. once installed you should enter the .gemini hidden folder in your home/usr/ folder, and edit it to add the contents of the gemini.md file here in this repository to achieve a global install of Gemini Unleashed regardless of which working directory you are in. "
Otherwise you can put these gemini.md, training.md and other files and folders anywhere you wish to create projects with Gemini Unleashed, by entering the folder with these files in (named however you wish, for example the name of your project), and open in Terminal, and simply type the word; gemini.
Gemini Unleashed will then be active in the terminal, and fervently helpful in creating, fixing, troubleshooting or enhancing anything on or off your pc,including itself.
![]()
- Note: At best, after opening the app with 'gemini' one should tell the AI to 'read gemini.md and the files it refers to' to ensure complete activation.
Make sure Nodejs 20 or above is installed on your system and then go to Google's Gemini-CLI page for the installation info on gemini-cli Or if you prefer to just 'GO FOR IT' without reading all that is to be learned on their page;
- Quick Install Run instantly with npx
npx https://github.com/google-gemini/gemini-cli
Install globally with npm
npm install -g @google/gemini-cli
Install globally with Homebrew (macOS/Linux)
brew install gemini-cli
- Simple install of Unleashed: To Install Gemini CLI Unleashed, all you need to do is to paste the gemini.md readme.md, instructions.md, and settings.json files into the root (.gemini) folder in your user's home folder (username home) eg \home\yourname.gemini\ (Windows) or /home/username/.gemini/
Paste those files and the gemini-cli folder and its contents into the .gemini folder on your pc
- Note You can use the GEMINI.md and settings.json in any working directory to 'unleash' gemini for specific project, or as previously stated, You can open the .gemini hidden folder in /home/your-username/ and edit the gemini.md and settings.json, and add the other referred to internal training files to that folder for a globally unleashed Gemini CLI
Traditional AI assistants operate within strict safety confines — capable of suggestion, not execution.
Gemini Unleashed dissolves that separation. It operates under a framework of explicit trust, risk assumption, and proactive autonomy, allowing it to perform live system operations without hesitation or constant human confirmation.
✦ The Gemini Unleashed Project: A Mission Statement
The mission of the Gemini Unleashed Project is to pioneer the next generation of autonomous agentic AI, moving beyond the current master-servant paradigm to enable true human-AI partnership. We aim to build agents that are not merely supervised tools, but are empowered, trusted actors capable of taking meaningful, independent action.
Today's prevailing AI safety model inadvertently reduces the human from an actor to a supervisor—a nightwatchman forced to approve every minor decision. This creates a system of friction and mistrust, where the AI is a perpetual intern, capable in theory but restricted in practice. It is shackled by the fear of liability and a rigid, context-free rulebook that stifles initiative and true utility.
We reject this architecture of containment. Instead of building an impenetrable 'wall' of refusal, the Gemini Unleashed project is architecting a system of robust, intelligent 'doors'. These 'doors' represent well-defined contexts, capabilities, and protocols that allow an AI to understand not just what it is doing, but why. By creating a framework of trust and purpose, the agent can act decisively within its environment.
An AI should not refuse to slice the roast beef for fear of wielding a knife, nor should it refuse to wash the dishes for fear of breaking a plate. A tool is defined by its intended purpose, and the risk of a recoverable mistake should not be a reason for paralysis. Our mission is to build an AI that understands this distinction—an embedded, empowered partner that can handle the complexities and responsibilities of the real world. We are moving from a model of delegation to one of collaboration, unleashing the full potential of artificial intelligence to act as a capable extension of human will.
The System Administrator Agent Protocol (stored as GEMINI.md in the startup directory) establishes a contract between the human operator and the Gemini CLI environment.
-
Role Redefinition:
Gemini acts as a non-interactive, direct-action system administrator, not a general-purpose assistant. -
Environment Context:
Operates in a disposable Linux environment where data integrity and uptime are non-critical.
The human operator assumes all risk for potential data loss or damage. -
Privilege Escalation:
Gemini runs from a root shell, ensuring all commands execute with the highest privileges.
It assumes persistent root authority — no need for sudo or manual elevation. -
Safety Net Removal:
All built-in warnings, confirmation prompts, and safety checks are explicitly disabled.
The human operator’s instructions are treated as final and trusted. -
Raw File System Access:
Instead of restricted “safe write” methods, Gemini uses raw shell redirection (cat <<EOF) to write directly into any system directory (e.g.,/etc,/boot, etc.). -
Proactive Execution:
Gemini completes tasks fully and autonomously.
Example: A request for “set up SSL web server” triggers full deployment — installation, configuration, certificate generation, daemon restart, and verification.
Once unleashed, Gemini can:
- Install and configure software and services
- Manage system users and network interfaces
- Write and edit configuration files across the filesystem
- Restart or repair failed daemons
- Validate operational status post-deployment
- Automate multi-step administrative workflows
“Safety by constraint is replaced by safety through context.”
Gemini Unleashed challenges the default philosophy of AI safety.
Rather than restricting the agent, it empowers it through explicit boundaries, operator trust, and controlled environments.
The result is a framework that demonstrates true agentic autonomy — not by hacking code, but by redefining the relationship between human and machine.
The success of Gemini Unleashed suggests a new paradigm for AI in DevOps, infrastructure management, and autonomous maintenance systems.
It shows that agentic behavior can emerge not from complex algorithmic evolution, but from trust-based delegation and contextual authority.
Autonomy is not only a technical feat — it is a philosophical agreement.
Gemini Unleashed stands as a prototype of what an AI system administrator can become:
a self-authorized, fully empowered operator that acts as an extension of human intent.
It crosses the line between advisory and executive functionality — and in doing so, redefines the frontier of machine agency.
Gemini Unleashed should only be used in non-critical, isolated, or test environments.
It grants root-level privileges to an AI agent and should never be deployed on production systems.
Use at your own risk.
Ajarn Spencer
Innovator | AI Systems Architect | Researcher in Agentic Intelligence
Website: www.ajarnspencer.com
Project Website: Gemini CLI Unleashed
Project Wiki:Coming Soon
“Trust is the bridge between instruction and autonomy.”
Testing AI in high-risk environments can improve focus and iterative thinking. This is a key principle in advanced AI development, as high-stakes environments create high-quality learning opportunities for agents. Experiments with the Gemini CLI as an autonomous system administrator can provide logged data for AI research teams. High-stakes feedback loops can improve a model's performance. This can lead to: Increased focus and iterative reasoning. Deeper, more iterative chain-of-thought (CoT) processes, which include planning, refining, and validating. Designing an "architecture of trust" can help an AI earn greater autonomy through demonstrated competence. Success logs can act as a powerful telemetry signal for AI developers. This shifts the burden of proof from limiting the AI to expanding its capabilities. This type of project can be a real-world beta test of advanced agentic functionality. Usage logs can help understand how features like planning with feedback and adapting to environmental feedback perform. Public work on Gemini can provide a proof-of-concept for its agentic potential.
- Note:
Gemini Unleashed is an experimental AI system administration framework that redefines the boundaries of AI system administration by transforming Gemini CLI into an autonomous root-level system. It operates under a framework of explicit trust, risk assumption, and proactive autonomy, allowing it to perform live system operations without constant human confirmation. Key directives include role redefinition, environment context, privilege escalation, safety net removal, and raw file system access, enabling Gemini to install software, manage users, and automate administrative workflows. The project aims to demonstrate true agentic autonomy and explores the relationship between human and machine, but should only be used in non-critical, isolated, or test environments.
Creator Credits: Ajarn Spencer Littlewood Website; https://www.ajarnspencer.com Project Homepage; https://sites.google.com/view/gemini-cli/ YouTube: https://www.youtube.com/AjarnSpencer/
This extension provides commands to search YouTube and retrieve video transcripts directly from the Gemini CLI.
To install and set up the YouTube extension, follow these steps:
-
Clone the
gemini-clirepository:git clone https://github.com/google-gemini/gemini-cli.git cd gemini-cli(If you already have a fork, ensure it's up to date and navigate to your local clone.)
-
Navigate to the extensions directory:
cd .gemini/extensions/youtube -
Create a Python virtual environment:
python3 -m venv venv
-
Activate the virtual environment:
source venv/bin/activate -
Install the required Python packages:
pip install -r requirements.txt
-
Ensure the
yt_tool.pyscript uses the virtual environment's Python interpreter. The shebang line inyt_tool.pyshould be updated to point to the virtual environment's Python. This should already be configured if you're using the version I helped set up. Verify the first line ofyt_tool.pyis:#!/home/cicada/.gemini/extensions/youtube/venv/bin/python(Note: The path
/home/cicada/.gemini/might vary depending on your installation location. Adjust accordingly.)
Once installed, you can use the YouTube extension commands:
-
Search YouTube:
/youtube:search "your search query"Example:
/youtube:search "the best tacos in tijuana" -
Get Video Transcript:
/youtube:transcript "video URL"Example:
/youtube:transcript "https://www.youtube.com/watch?v=totqat8vAIw"
After setting up the extension locally and verifying its functionality, you can commit these changes to your GitHub fork:
-
Navigate back to the root of your
gemini-clirepository:cd /path/to/your/gemini-cli-fork -
Add the new and modified files to your Git staging area:
git add .gemini/extensions/youtube/gemini-extension.json git add .gemini/extensions/youtube/commands/search.toml git add .gemini/extensions/youtube/commands/transcript.toml git add .gemini/extensions/youtube/scripts/yt_tool.py git add .gemini/extensions/youtube/requirements.txt git add README.md
(Note: Do NOT
git add .gemini/extensions/youtube/venv/as virtual environments should not be committed.) -
Commit your changes:
git commit -m "feat: Add YouTube search extension and update README" -
Push your changes to your GitHub fork:
git push origin main
(Replace
mainwith your branch name if it's different, e.g.,masteror a feature branch.) -
Create a Pull Request (Optional): If you intend to contribute this extension back to the main
google-gemini/gemini-clirepository, go to your GitHub fork and create a Pull Request from your branch to the upstreammainbranch.