Skip to content
fkillerPublic

About

GnuNae – Codex-native Autonomous Browser

Resources

Stars

2 stars

Watchers

0 watching

Forks

Repository files navigation

GnuNae

An Electron-based browser with an AI-powered Codex sidebar for intelligent web automation.

🌐 Website: www.gnunae.com

GnuNae - AI Browser with no limit | Product Hunt

⚠️ Alpha Warning: This app is still in alpha stage. Do not use it in production or with sensitive data.

Maintenance note: Some historical release and maintenance details in this README may lag behind the current workflows. For Codex-first maintenance, current build/release authority, and stale-doc handling, see AGENTS.md, docs/maintenance-playbook.md, docs/test-matrix.md, and docs/release-checklist.md. For Codex model, runtime, and Docker sandbox failure handling, see docs/codex-model-runtime.md.

Architecture

graph TB
    subgraph Electron["Electron App"]
        Main["Main Process<br/>(main.ts)"]
        Preload["Preload Script<br/>(preload.ts)"]
    end
    
    subgraph UI["React UI"]
        App["App.tsx"]
        Sidebar["CodexSidebar"]
        AddressBar["AddressBar"]
        BottomPanel["BottomPanel<br/>(Terminal + Output)"]
        Settings["Settings"]
    end
    
    subgraph PromptEngine["Prompt Engineering"]
        ModeInstr["Mode Instructions<br/>(Ask/Agent/Full)"]
        PrePrompt["Pre-Prompt<br/>(System Instructions)"]
        UserData["User Data Context<br/>(PDS)"]
        PageContext["Page Context<br/>(URL, Title, Content)"]
        UserPrompt["User Prompt"]
    end
    
    subgraph BrowserView["Browser View"]
        InternalPage["Web Content"]
        InternalCDP["CDP Endpoint<br/>(port 9222)"]
    end
    
    subgraph ExternalBrowser["External Browser"]
        ExternalPage["Web Content<br/>(Chrome/Edge/Brave)"]
        ExternalCDP["CDP Endpoint<br/>(port 9223+)"]
    end
    
    subgraph PIE["PIE - Native Mode"]
        NativeCodex["Codex CLI"]
        NativePlaywright["Playwright MCP"]
        NativeTerminal["Native Shell<br/>(cmd/bash/zsh)"]
    end
    
    subgraph Docker["Docker - Virtual Mode"]
        DockerCodex["Codex CLI"]
        DockerPlaywright["Playwright MCP"]
        DockerTerminal["Docker Exec<br/>(bash)"]
    end
    
    OpenAI["OpenAI API"]
    
    Main --> Preload
    Preload <--> UI
    UI --> Sidebar
    UI --> BottomPanel
    
    Sidebar --> PromptEngine
    PromptEngine --> |IPC| Main
    
    Main --> |spawn| PIE
    Main --> |container| Docker
    
    BottomPanel --> |xterm.js| NativeTerminal
    BottomPanel --> |xterm.js| DockerTerminal
    
    NativeCodex --> OpenAI
    DockerCodex --> OpenAI
    
    NativeCodex --> NativePlaywright
    DockerCodex --> DockerPlaywright
    
    NativePlaywright --> |CDP| InternalCDP
    NativePlaywright --> |CDP| ExternalCDP
    DockerPlaywright --> |CDP| InternalCDP
    DockerPlaywright --> |CDP| ExternalCDP
    
    InternalCDP --> InternalPage
    ExternalCDP --> ExternalPage
Loading

Component Overview

Component Description
Main Process Electron main, window management, IPC handlers, Codex spawning with -c flags
BrowserView Chromium-based web content rendering with CDP endpoint
React UI Sidebar, address bar, terminal panel, settings overlay
Bottom Panel xterm.js terminal (Native/Docker) + Output logs
Codex CLI OpenAI's CLI for AI-powered automation (configured at runtime)
Playwright MCP DOM interaction via Chrome DevTools Protocol (CDP)

Features

  • 🌐 Full Browser - Chrome-based web browser with address bar and navigation
  • 🪟 Multi-Window - Open multiple independent windows (Cmd/Ctrl+N)
  • 📑 Multi-Tab - Multiple tabs per window with tab bar
  • 💬 Chat Mode - Sidebar-only mode for use with external browsers (Chrome, Edge, etc.)
  • 🔗 External Browser Support - Connect Codex to your existing browser with full automation
  • 🤖 Codex Sidebar - AI assistant powered by OpenAI's Codex CLI
  • 📎 File Attachments - Choose files with + or drag them onto the Codex sidebar
  • 🐳 Virtual Mode - Docker-based sandbox for isolated Codex + Playwright execution
  • 💻 Interactive Terminal - Full PTY emulation with xterm.js (native shell or Docker bash)
  • 📋 Output Panel - View backend process logs and Codex execution status
  • 📋 Task Manager - Save, schedule, and run automated tasks
  • 🔐 OpenAI Auth - Sign in with your OpenAI account
  • 🔧 Page Analysis - Codex can see and analyze your current page
  • 🎯 MCP Integration - Model Context Protocol for browser control
  • 💾 Personal Data Store (PDS) - Persistent storage for user data that Codex can access and update
  • ⏰ Scheduled Tasks - Run tasks hourly, daily, or weekly at specific times
  • ⚠️ Failure Detection - Automatic detection of CAPTCHA, 2FA, and login blocks

Demo Videos

Use Case 1: AI Web Automation

Watch GnuNae Use Case 1

Use Case 2: Smart Page Analysis

Watch GnuNae Use Case 2

Installation

Prerequisites

  • Node.js 18+
  • npm or yarn
  • ChatGPT Pro or Plus subscription (required for Codex CLI)

Setup

# Clone the repository
git clone https://github.com/fkiller/GnuNae.git
cd GnuNae

# Install dependencies
npm install

# Build the application
npm run build

# Run in development
npm run start

First-time users can browse without signing in. Use the in-app OpenAI sign-in button when you want Codex AI features.

Virtual Mode (Docker)

To use Virtual Mode, you need Docker Desktop installed. This runs Codex and Playwright in an isolated container.

GnuNae pulls ghcr.io/fkiller/gnunae/sandbox:latest before starting a sandbox. If that pull fails but a cached image already exists, it can continue with the cached image. Local Docker builds are mainly for development or manual recovery.

# Build the Docker sandbox image locally
npm run build:docker

# Or build without cache (recommended after updates)
npm run build:docker:clean

# Build everything (app + Docker image)
npm run build:all
Script Description
build:docker Build the Docker sandbox image and tag it as local + GHCR latest
build:docker:clean Build Docker image without cache and tag it as local + GHCR latest
build:all Build app + Docker image

Enable Virtual Mode in Settings when Docker is detected.

External Browsers & Chat Mode

GnuNae can now control your existing external browsers (Chrome, Edge, Brave, Opera) instead of using the built-in window.

  1. Manage Browsers: Go to Settings → External Browsers to scan for installed browsers.
  2. Create Shortcuts: Generate special shortcuts that launch your browser connected to GnuNae.
  3. Chat Mode: Launching via shortcut opens GnuNae in "Chat Mode" - a floating sidebar that attaches to your external browser.
  4. Full Automation: Codex can read, analyze, and control the external browser just like the built-in one.

Usage

  1. Launch the app - A browser window opens with a sidebar
  2. Navigate - Use "Browse without Codex" or the address bar to visit any website
  3. Sign in for Codex - Click "Sign in to OpenAI" when you want AI features
  4. Ask Codex - Type a prompt in the sidebar (e.g., "list all links on this page")
  5. Get results - Codex analyzes the page and responds

Example Prompts

  • "Summarize this page"
  • "Find all job listings mentioning Python"
  • "What are the main topics covered here?"
  • "Google my address" (Codex will ask for your address and remember it)
  • "Store all property information" (Codex extracts and saves data from the page)

Personal Data Store (PDS)

The PDS allows Codex to remember your personal information across sessions:

  1. Automatic Prompting - When Codex needs info (email, address, etc.), a smart card appears for you to enter it
  2. Persistent Storage - Data is saved to ~/.gnunae/datastore.json and reused automatically
  3. Web Extraction - Ask Codex to "store" information from pages (e.g., property details from Zillow)
  4. Manage in Settings - View, edit, or delete stored data in the Settings panel

Example workflow:

You: "Search my address on Zillow"
Codex: [Shows smart card asking for address]
You: [Enter "123 Main St, Boston MA"]
Codex: [Searches Zillow, saves address for future use]

Prompt Architecture

When you send a prompt, GnuNae constructs the full prompt in this order:

Order Component Description
1 Mode Instructions Behavior constraints based on mode (Ask/Agent/Full Access)
2 Pre-Prompt System instructions from Settings
3 User Data Context Personal data from the Data Store
4 Page Context Current URL, title, and page content
5 User Prompt Your actual request

Mode behaviors:

Mode Behavior
💬 Ask Read-only - can only describe page, refuses to click/submit/navigate
🤖 Agent Confirms critical actions (payments, final submissions, account changes)
⚡ Full Access 100% autonomous - no confirmations needed

Building for Distribution

# macOS (DMG + ZIP)
npm run pack:mac

# Mac App Store (Universal PKG)
npm run pack:mac-mas
npm run deploy:mas

# Windows (Microsoft Store APPX)
npm run pack:win

# Linux (AppImage + DEB)
npm run pack:linux

For detailed CI/CD pipeline documentation, code signing setup, and environment configuration, see:

Configuration

GnuNae configures Codex CLI automatically at runtime via -c flags. No manual configuration needed - GnuNae works out of the box without modifying ~/.codex/config.toml.

If you have custom settings in ~/.codex/config.toml, GnuNae overrides Codex spawn configuration for app-managed browser automation. Current committed code uses the generated model list in src/core/codex-models.json (default gpt-6-astra, fallback gpt-6-luna), passes the selected/default model explicitly with xhigh reasoning in Native mode, and sends the selected model to Docker/Virtual Mode instead of relying on the Codex CLI account default. The current pinned CLI is @openai/codex@0.169.0. See docs/codex-model-runtime.md for model/runtime failure handling and Docker parity requirements. Maintainers can run the OpenAI model pipeline task from GitHub Actions (.github/workflows/codex-models.yml) or execute the automated weekly maintenance runner (./scripts/run-weekly-maintenance.sh) to regenerate the model manifest, update Codex CLI pins across Native/package/Docker paths, refresh lockfiles, update documentation, and publish multi-channel releases.

On Windows Store updates, the bundled Node.js and Codex CLI are copied to stable app data so an app update cannot lose them. Existing copies are compared with the bundled version and refreshed when the Store package contains a newer CLI. If an older CLI reports a models_cache effort error such as unknown variant \max``, GnuNae performs one bounded runtime update and then retries with the generated fallback model. A network or permission failure finishes with a visible error instead of leaving the chat in an endless “Updating Codex CLI” state. Virtual Mode uses the separately pinned Docker sandbox image and reports when that image needs to be rebuilt or pulled.

Project Structure

src/
├── electron/              # Main process
│   ├── main.ts           # App entry, window management, IPC handlers, Codex spawning
│   └── preload.ts        # Context bridge for renderer
├── ui/                   # Renderer process (React)
│   ├── index.tsx         # React entry point
│   ├── App.tsx           # Main UI layout
│   ├── App.css           # Global styles
│   └── components/
│       ├── AddressBar.tsx      # URL navigation bar
│       ├── CodexSidebar.tsx    # AI assistant sidebar
│       ├── DataRequestCard.tsx # Smart card for PDS data requests
│       ├── TaskManager.tsx     # Task Manager panel
│       ├── RightPanel.tsx      # Chat/Task Manager wrapper
│       ├── SaveTaskCard.tsx    # Save task prompt card
│       ├── TabBar.tsx          # Multi-tab bar
│       ├── BottomPanel.tsx     # Terminal (xterm.js) + Output logs
│       ├── Settings.tsx        # Settings panel (includes PDS editor)
│       └── About.tsx           # About dialog
└── core/                   # Shared utilities
    ├── auth.ts             # OpenAI authentication
    ├── browser-detector.ts # External browser detection (Chrome, Edge, etc.)
    ├── codex-models.json   # Generated OpenAI Codex model manifest
    ├── datastore.ts        # Personal Data Store service
    ├── runtime-manager.ts  # Node.js/npm/Codex runtime management
    ├── tasks.ts            # Task service and scheduler
    ├── settings.ts         # App settings & pre-prompt
    ├── schema.ts           # Type definitions
    ├── docker-manager.ts   # Docker sandbox lifecycle management
    └── vault.ts            # Secure storage

docker/                   # Virtual Mode sandbox
├── Dockerfile            # Container image definition
├── entrypoint.sh         # Container startup script
├── api-server.js         # REST API for Codex execution
└── playwright.config.ts  # Playwright MCP configuration

scripts/                  # Build, packaging, and maintenance automation
├── run-weekly-maintenance.sh       # Non-interactive weekly maintenance entrypoint
├── weekly-maintenance-runner.js    # Automated weekly release & store verification runner
├── update-codex-models.js          # Official Codex model manifest generator
└── update-openai-model-pipeline.js # Native/Docker Codex CLI pin synchronizer

docs/                     # GitHub Pages (gnunae.com) & maintenance docs
├── index.html            # Landing page
├── CNAME                 # Custom domain
├── handoff/              # Cross-harness maintenance runbooks and weekly reports
└── assets/               # Logo, videos

.github/
├── dependabot.yml            # Weekly npm dependency updates
└── workflows/
    ├── ci.yml                # Multi-OS build verification (Windows, macOS, Linux)
    ├── release.yml           # Tag-triggered macOS, Linux, MAS, and Microsoft Store release pipeline
    ├── docker.yml            # GHCR sandbox container image build and publication
    ├── codex-models.yml      # Scheduled/manual OpenAI model manifest and Codex CLI pin pipeline
    ├── maintenance-watch.yml # Weekly dependency, runtime, and website health monitor
    └── store-status-watch.yml# 6-hour Microsoft Store & Mac App Store submission status monitor

Tech Stack

  • Electron - Desktop app framework
  • React - UI library
  • TypeScript - Type safety
  • Vite - Build tool
  • OpenAI Codex - AI code assistant

Roadmap

Status Feature
✅ Done Electron-based browser integrated with Codex-Playwright MCP
✅ Done Multi-window support with isolated Codex sessions
✅ Done Multi-tab support with tab bar
✅ Done Personal Data Store (PDS) - persistent storage with smart card UI
✅ Done Two-way PDS integration - Codex can request AND store data
✅ Done Task Manager - save, schedule, and automate tasks
✅ Done Virtual Mode - Docker sandbox for Codex + Playwright isolation
✅ Done External Browser Support (Chrome, Edge, Brave, Opera)
✅ Done Chat Mode (Sidebar-only window)
🔜 Planned Remote backend (home server, cloud) with VNC streaming
🔜 Planned Project management for multi-page workflows
🔜 Planned More LLM options including local LLM support

Version History

v1.1.14 (2026-11-15)

  • Weekly Maintenance & Codex Runtime Update
    • Upgraded pinned @openai/codex CLI from 0.167.0 to 0.169.0 across Native mode (package.json, resources/codex, src/core/runtime-manager.ts, scripts/install-codex.js) and Virtual Mode (docker/Dockerfile).
    • Synchronized upstream Codex model catalog (gpt-6-astra, gpt-6.1-sol, gpt-6.1-terra, gpt-6-luna; default gpt-6-astra, fallback gpt-6-luna; added models: none; decommissioned/deprecated models: none), refreshed package lockfiles, and synchronized documentation (README.md, docs/codex-model-runtime.md, docs/PERIODIC_MAINTENANCE.md, docs/index.html).
    • Published multi-channel release across GitHub Releases (macOS DMG/ZIP, Linux AppImage/DEB), GHCR Docker sandbox (ghcr.io/fkiller/gnunae/sandbox:latest & v1.1.14), Microsoft Store APPX, and Mac App Store universal PKG.

v1.1.13 (2026-11-08)

  • Weekly Maintenance & Codex Runtime Update
    • Upgraded pinned @openai/codex CLI from 0.166.0 to 0.167.0 across Native mode (package.json, resources/codex, src/core/runtime-manager.ts, scripts/install-codex.js) and Virtual Mode (docker/Dockerfile).
    • Synchronized upstream Codex model catalog (gpt-6-astra, gpt-6.1-sol, gpt-6.1-terra, gpt-6-luna; default gpt-6-astra, fallback gpt-6-luna; added models: none; decommissioned/deprecated models: none), refreshed package lockfiles, and synchronized documentation (README.md, docs/codex-model-runtime.md, docs/PERIODIC_MAINTENANCE.md, docs/index.html).
    • Published multi-channel release across GitHub Releases (macOS DMG/ZIP, Linux AppImage/DEB), GHCR Docker sandbox (ghcr.io/fkiller/gnunae/sandbox:latest & v1.1.13), Microsoft Store APPX, and Mac App Store universal PKG.

v1.1.12 (2026-11-03)

  • Codex Model Catalog Sync (Added: GPT-6.1-Sol / GPT-6.1-Terra / GPT-6-Luna; Decommissioned: GPT-5.6-Sol / GPT-5.6-Terra / GPT-5.6-Luna) & Store Display Name Unification
    • Synchronized upstream Codex model catalog (gpt-6-astra, gpt-6.1-sol, gpt-6.1-terra, gpt-6-luna; default gpt-6-astra, fallback gpt-6-luna; added models: gpt-6.1-sol, gpt-6.1-terra, gpt-6-luna; decommissioned/deprecated models: gpt-5.6-sol, gpt-5.6-terra, gpt-5.6-luna) across src/core/codex-models.json, Native/Docker runtime configuration, Microsoft Store certification notes, and documentation.
    • Fixed scripts/weekly-maintenance-runner.js and the gnunae-weekly-maintenance skill to always execute npm run update:codex-models and npm run check:codex-models-source against https://developers.openai.com/codex/models.
    • Unified store display name to GNUNae - AI Browser across Mac App Store (appInfoLocalizations in scripts/submit-mas.js) and Microsoft Store (baseListing.title in scripts/msstore-certification.js), and resolved App Store Connect editable ageRatingDeclaration (socialMedia=false) lookup.

v1.1.11 (2026-11-01)

  • Weekly Maintenance & Codex Runtime Update
    • Upgraded pinned @openai/codex CLI from 0.164.0 to 0.166.0 across Native mode (package.json, resources/codex, src/core/runtime-manager.ts, scripts/install-codex.js) and Virtual Mode (docker/Dockerfile).
    • Verified model manifest alignment, refreshed package lockfiles, and synchronized documentation (README.md, docs/codex-model-runtime.md, docs/PERIODIC_MAINTENANCE.md, docs/index.html).
    • Published multi-channel release across GitHub Releases (macOS DMG/ZIP, Linux AppImage/DEB), GHCR Docker sandbox (ghcr.io/fkiller/gnunae/sandbox:latest & v1.1.11), Microsoft Store APPX, and Mac App Store universal PKG.

v1.1.10 (2026-10-25)

  • Weekly Maintenance & Codex Runtime Update
    • Upgraded pinned @openai/codex CLI from 0.163.0 to 0.164.0 across Native mode (package.json, resources/codex, src/core/runtime-manager.ts, scripts/install-codex.js) and Virtual Mode (docker/Dockerfile).
    • Verified model manifest alignment (gpt-6-astra default, gpt-5.6-luna fallback) and refreshed package lockfiles.
    • Published multi-channel release across GitHub Releases (macOS DMG/ZIP, Linux AppImage/DEB), GHCR Docker sandbox (ghcr.io/fkiller/gnunae/sandbox:latest & v1.1.10), Microsoft Store APPX, and Mac App Store universal PKG.

v1.1.9 (2026-10-18)

  • Weekly Maintenance & Codex Runtime Update
    • Upgraded pinned @openai/codex CLI from 0.162.1 to 0.163.0 across Native and Docker Virtual Mode runtimes.
    • Synchronized website release metadata (docs/index.html) and published multi-store artifacts.

v1.1.8 (2026-10-10)

  • Weekly Maintenance & Codex Runtime Update
    • Upgraded pinned @openai/codex CLI from 0.160.0 to 0.162.1 across Native and Docker Virtual Mode runtimes.
    • Extended CI/CD workflow watch timeouts in scripts/weekly-maintenance-runner.js and synchronized the gnunae-weekly-maintenance skill definition.

v1.1.7 (2026-10-04)

  • Weekly Maintenance & Automated Runner
    • Upgraded pinned @openai/codex CLI from 0.155.1 to 0.160.0 across Native and Docker Virtual Mode runtimes.
    • Added non-interactive weekly maintenance automation (scripts/run-weekly-maintenance.sh, scripts/weekly-maintenance-runner.js) and the gnunae-weekly-maintenance skill for isolated worktree verification, release tagging, and multi-store monitoring.

v1.1.6 (2026-09-23)

  • OpenAI Model Pipeline & Next-Gen Models
    • Upgraded @openai/codex to 0.155.1 and updated src/core/codex-models.json with gpt-6-astra (default), gpt-5.6-sol, gpt-5.6-terra, and gpt-5.6-luna (fallback).
    • Added cross-harness maintenance handoff documentation (docs/handoff/) under standing maintenance authorization.

v1.1.0 - v1.1.4 (2026-07 - 2026-08)

  • Generated Codex Model Manifest & Bounded Runtime Repair
    • Added scripts/update-codex-models.js, scripts/update-openai-model-pipeline.js, and .github/workflows/codex-models.yml to track official OpenAI Codex models and keep Native/Docker pins synchronized.
    • Implemented bounded Native Codex CLI runtime repair and automatic fallback-model retry for models_cache deserialization (unknown variant \max``) and outdated-CLI errors.
  • Store & Release Automation
    • Added .github/workflows/store-status-watch.yml (6-hour Microsoft Store & Mac App Store status monitor) and .github/workflows/maintenance-watch.yml (weekly dependency & website health monitor).
    • Automated Partner Center certification notes (scripts/msstore-certification.js) and Mac App Store AFTER_APPROVAL review submission.
  • macOS File Attachments
    • Fixed Codex sidebar file picker (+) and Finder drag-and-drop attachments for Native and sandboxed MAS builds.

v0.8.33 - v1.0.60 (2026-02 - 2026-07)

  • Automated Store Distribution & Packaging
    • Automated Microsoft Store APPX/MSIX publishing via msstore CLI (build-msstore) and universal Mac App Store packaging/upload (build-mas) in .github/workflows/release.yml.
    • Upgraded packaging toolchain to electron-builder v26, Playwright 1.59.1, and @playwright/mcp 0.0.70.
    • Moved runtime and Codex resource copying to scripts/afterPack.js to support universal macOS MAS builds without symlink conflicts.

v0.8.32 (2026-02-07)

  • Dependency Upgrades
    • Codex CLI: 0.80.0 → 0.98.0 (GPT-5.3-Codex support, steer mode stable)
    • Playwright MCP: 0.0.55 → 0.0.64 (session management improvements)
    • Electron: 39.2.7 → 39.5.1 (staying within v39 for stability)
    • MCP SDK, React, Playwright, Zod, and other packages updated
  • New AI Model: GPT-5.3-Codex
    • Added to model selector (25% faster, improved agentic capabilities)
    • Released by OpenAI on Feb 5, 2026
  • macOS Runtime Bundling
    • Node.js and Codex CLI now bundled for macOS builds (arm64 + x64)
  • Docker Image Refresh
    • GnuNae now pulls the rolling GHCR latest sandbox image before Virtual Mode startup
    • Created periodic maintenance documentation

v0.8.0 (2026-01-12)

  • Interactive Terminal with xterm.js
    • Full PTY emulation via node-pty (arrow keys, tab completion, Ctrl+C)
    • Terminal persists when hiding/showing panel
    • Renamed "Console" tab to "Output" for clarity
  • Docker Terminal Support (Virtual Mode)
    • Terminal connects to Docker container bash via docker exec
    • Virtual Mode uses Electron's built-in CDP (no external browser required)
  • Improved Runtime Manager
    • Direct Node.js download using https/fs modules (no external node spawn)
    • Auto-install runtime on macOS/Linux if not present
    • Better shell detection (zsh, bash, sh candidates)
  • Terminal Fallback
    • Fallback process when node-pty fails
    • Spawn debounce prevents infinite restart loop

v0.7.1 (2026-01-11)

  • Embedded Node.js & Codex CLI
    • Windows: Node.js 22 LTS and Codex CLI bundled in package
    • macOS: Downloads Node.js and Codex to ~/Library/Application Support/GnuNae on first run
    • Settings UI shows runtime status (Node.js, npm, Codex CLI versions) under Native Mode
  • Downgraded electron-builder to 24.13.3 for compatibility

v0.7.0 (2026-01-10)

  • Cross-Platform Runtime Scripts
    • Added scripts/download-node.js for portable Node.js download
    • Added scripts/install-codex.js for local Codex CLI installation
    • RuntimeManager service for validation and path resolution
  • GitHub Actions updated for Windows builds with embedded runtime

v0.6.1 (2026-01-06)

  • Chat Mode & External Browsers
    • Support for External Browsers: Use Chrome, Edge, Brave, or Opera with GnuNae.
    • Chat Mode Window: Minimized sidebar-only interface when using external browsers.
    • CDP Integration: Real-time two-way control of external browsers via Chrome DevTools Protocol.
    • Docker & Chat Mode: Fixed complex CDP connection issues allowing Dockerized Codex to control external browsers via host.docker.internal.
    • Standalone Settings: Settings now open in a dedicated window in Chat Mode.
    • Shortcuts: Auto-generate shortcuts for your installed browsers with GnuNae integration.

v0.6.0 (2026-01-04)

  • Virtual Mode (Docker Sandbox)
    • Enables isolated execution of Codex CLI and Playwright MCP in a Docker container
    • Requires Docker Desktop installed on your machine
    • Shares OpenAI authentication with the container securely
    • Mounts working directory so attached files are accessible
    • Foundation for future remote backend support (home server, cloud)
    • Toggle via Settings panel when Docker is detected

v0.5.3 - v0.5.1 (2025-12-28 - 2025-12-27)

  • Bug fixes and stability improvements for multi-window support

v0.5.0 (2025-12-27)

  • Multi-Window Support
    • Open multiple independent GnuNae windows (Cmd/Ctrl+N)
    • Each window has isolated Codex sessions and working directory
    • Window-specific tab management and automation
    • Playwright MCP correctly targets each window's webview
  • Stability Improvements
    • Fixed iframe navigation polluting address bar URL
    • Protected application UI from accidental Playwright navigation
    • Improved tab selection guidance in pre-prompt

v0.4.4 - v0.4.1 (2025-12-24 - 2025-12-21)

  • Bug fixes for task execution and UI improvements

v0.4.0 (2025-12-21)

  • Task Execution System
    • Save prompts as reusable tasks with one-time, on-going, or scheduled triggers
    • Task Manager panel with favorites, running tasks, and scheduled countdowns
    • Background scheduler for automated task execution
    • Max concurrency setting (1-5 simultaneous tasks)
  • Failure Handling
    • CAPTCHA/2FA/login detection with warning cards
  • Menu Enhancements
    • Settings accessible from App menu (⌘,)
    • View menu: Show Chat (⌘1), Task Manager (⌘2), Hide Panel (⌘0)
    • About dialog with open source library attributions
  • UI Improvements
    • Chat/Task Manager toggle buttons in address bar
    • Collapsible right panel with dynamic browser resizing

v0.2.0 (2024-12-17)

  • Personal Data Store (PDS) with smart card UI
  • Multi-tab browser support

v0.1.0 (2024-12-01)

  • Initial release
  • Codex sidebar with OpenAI integration
  • MCP-based browser automation

License

MIT

Contributing

Contributions welcome! Please open an issue or PR.


Built with ❤️ for AI-powered browsing

About

GnuNae – Codex-native Autonomous Browser

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages