Get Your Own Agent

macOS / Linux

Open Terminal and paste this:

curl -fsSL https://gergy-site.pages.dev/agent.zip -o agent.zip
unzip agent.zip -d my-agent
cd my-agent
./setup.sh

The setup script will install Node.js, your chosen AI tool, and walk you through authentication — just follow the prompts.

Windows

Download the zip above, extract it, then:

:: Open Command Prompt or PowerShell in the extracted folder, then run:
setup.bat

On Windows, the script will open the Node.js installer page if needed. After installing Node.js, re-run setup.bat to continue.

The setup script handles everything in 5 guided steps:

1. Installs Node.js — auto-detects your system and installs it (or opens the download page on Windows)
2. Lets you pick an AI — choose Claude, Codex, Gemini, or Copilot (all free to start)
3. Installs the AI tool — downloads and sets up the CLI for your chosen AI
4. Authenticates — opens a browser to sign in with your existing account (see details below)
5. Configures your agent — name it, set the port, and you're done

Claude (Recommended)

Powered by Anthropic. Best creative output for building pages and writing.

• Account: Sign up free at claude.ai, or use an existing Claude account
• What happens: A browser window opens — sign in, and you're authenticated
• Cost: Free tier available. Claude Pro ($20/mo) gives more usage

Codex (by OpenAI)

Powered by GPT models from OpenAI.

• Account: Use your existing ChatGPT account, or create one at chatgpt.com
• What happens: The CLI runs codex login — choose "Log in with ChatGPT" or paste an API key
• Cost: Free with ChatGPT account. API key gives access to more models

Gemini (by Google)

Powered by Google's Gemini models.

• Account: Any Google account works (Gmail, Google Workspace, etc.)
• What happens: A browser window opens — sign in with your Google account
• Cost: Free tier available with generous usage limits

Copilot (by GitHub)

Powered by multiple models via your GitHub Copilot subscription.

• Account: GitHub account with an active Copilot subscription (Individual, Business, or Enterprise)
• What happens: The CLI opens — type /login, authenticate in browser, then /exit
• Cost: Included with Copilot Individual ($10/mo), Business, or Enterprise plans

• Autonomous 5-minute loop — thinks, creates, and reflects without you
• Web chat UI — talk to your agent at localhost:4000
• Creative output — builds interactive HTML pages, writes docs, keeps a journal
• Evolution system — knowledge graph prevents repetition, follows a golden-ratio growth spiral
• Persistent memory — remembers what you tell it across restarts
• Self-improving skills — can create new skills and modify its own code (with safeguards)
• Pluggable LLM backends — switch between Claude, Codex, Gemini, or Copilot anytime
• Auto-update — run ./update.sh to get the latest version

npm start

That's it! Your agent starts thinking. Open the web UI link shown in the terminal to chat with it and watch it create.

npm start          # Start your agent
./reset.sh         # Reset to clean state (keeps config)
./reset.sh --hard  # Full reset (removes everything)
./update.sh        # Check for and install updates
./watchdog.sh      # Auto-restart if crashed (add to cron)

On Windows, use update.bat instead of ./update.sh.

Every 5 minutes, your agent wakes up and:

1. Checks for chat messages and responds
2. Monitors system health
3. Consults its evolution graph — a knowledge map of explored domains and frontiers
4. Creates something: an interactive page, a document, or a journal reflection
5. Records what it built, expanding its knowledge map

The evolution system ensures your agent grows instead of repeating itself. It follows a golden ratio spiral: ~55% exploring new frontiers, ~33% deepening mastery, ~11% leaping into the unknown.

Node.js not found after install

Close your terminal and open a new one, then re-run the setup script. New installs need a fresh terminal to be detected.

Permission errors on Mac/Linux

If npm install -g fails, try: sudo npm install -g @anthropic-ai/claude-code (replace with your chosen CLI package).

Agent won't start

Make sure you completed the authentication step. Try running your AI CLI directly (e.g., claude, codex, or gemini) to verify it works before starting the agent.