Changelog

All notable changes to Gigaclaw are documented here. Follows semantic versioning. Latest release: v1.9.1

v1.9.2

Latest2026-03-28

Stabilization release: zero-config bootstrap with auto-generated secrets, JWT hardening, Turbopack removal, hybrid mode auto-detect, health check endpoint, and new CLI commands (doctor, reset-build). Full E2E verified across 4 scenarios.

Auth & JWT Hardening

  • fixAuto-generate NEXTAUTH_SECRET, AUTH_SECRET, and JWT_SECRET during bootstrap — no manual config needed
  • fixRuntime fail-fast check: server refuses to start if auth secrets are missing
  • fixJWT session signing now uses auto-generated secret, resolving token validation errors

Turbopack Removal

  • fixSwitched dev script from 'next dev --turbopack' to standard 'next dev' for stability
  • fixAuto-delete .next directory before server start to prevent stale cache issues

Workspace & Bootstrap

  • fixWorkspace isolation: always creates clean project directory with unique suffix on conflict
  • fixDeterministic bootstrap: auto-generates all secrets and env vars, zero user input required
  • featHybrid mode auto-detect: detects missing API key, switches to local mode, displays mode in logs

Health Check & Observability

  • featNew /api/health endpoint validates auth, JWT, LLM, database, cron, and mode status
  • featNew /api/debug endpoint for runtime diagnostics
  • featStructured startup logs with LLM routing and mode information
  • featBootstrap Phase 8: automatic health check validation before declaring success

CLI Enhancements

  • featNew 'gigaclaw doctor' command: validates Node.js, Docker, Ollama, and environment readiness
  • featNew 'gigaclaw reset-build' command: clears .next cache and node_modules for clean restart
  • featNew '--clean-install' flag: forces fresh npm install with cache purge

Cron Control

  • fixENABLE_CRON=false by default in bootstrap — prevents background jobs from running during initial setup
  • fixCron execution gated on ENABLE_CRON env var in instrumentation.js

Testing

  • feat116/118 regression tests pass (2 skipped headless-only), 15 new v1.9.2 tests added
  • feat4 E2E scenarios verified: no API keys, conflicting dir, missing Ollama, full hybrid with ANTHROPIC_API_KEY

v1.9.1

Stable2026-03-28

Post-install runtime fixes: resolves all crash-on-startup errors found during full E2E testing. Dashboard, AI chat (Claude Sonnet 4.5), and all core features verified working end-to-end via 'npx gigaclaw@latest'. 11 bug fixes across scaffold, brand, auth, and component imports.

Scaffold & Bootstrap Fixes

  • fixscaffold.mjs: skip symlinks in getTemplateFiles() walker — EISDIR crash when templates/.claude/skills symlink was encountered during file copy
  • fixbootstrap.mjs: detect free port BEFORE setup phase so NEXTAUTH_URL and AUTH_URL are written with the correct port (not hardcoded 3000)
  • fixbootstrap.mjs: write AUTH_URL and NEXTAUTH_URL with dynamic port to .env — prevents auth redirect loop when port 3000 is occupied

Template & Config Fixes

  • fixtemplates/app/layout.js: fix brand.json import path from ../../config to ../config (was 3 levels deep, correct is 2)
  • fixtemplates/app/components/ascii-logo.jsx: same brand.json import path fix
  • fixtemplates/config/brand.json: add missing config file to scaffold — was present in gigabot source but never copied to templates, causing Module not found crash on startup

Library & Component Fixes

  • fixlib/brand.js: rewrite to be browser-safe — removed fs.readFileSync which caused Turbopack to fail bundling client components that import brand.js
  • fixlib/brand-server.js: new server-only brand loader using fs.readFileSync for server components and API routes
  • fixlib/chat/components/index.js: import from share-dialog.js (compiled) not share-dialog.jsx (raw JSX) — raw JSX in .js file caused SyntaxError in Turbopack chunk
  • fixlib/chat/components/chat-header.js: import from rename-dialog.js not rename-dialog.jsx — same raw JSX bundling fix
  • fixlib/db/vector-store-meta.js: add missing module — knowledge-base-actions.js imported it but it was never created, causing Module not found crash

E2E Verification

  • featFull E2E test passed: npx gigaclaw@latest > install > server start > user creation > login > dashboard > AI chat with Claude Sonnet 4.5 (ANTHROPIC_API_KEY). Zero manual steps required.

v1.9.0

Stable2026-03-27

One-Command Bootstrap: npx gigaclaw@latest now fully automates the entire developer setup. Plus: critical Drizzle migration fix, retry-safe npm install with exponential backoff and pnpm fallback. 101/103 regression tests pass.

One-Command Bootstrap

  • featbin/bootstrap.mjs: new 7-phase orchestrator — detect env, create dir, scaffold, install, configure, write .env, start server + open browser.
  • featbin/scaffold.mjs: extracted scaffolding logic shared by both gigaclaw init and the bootstrap.
  • feat--interactive flag: opt into the full interactive setup wizard instead of smart defaults.
  • featSmart defaults (non-interactive): GIGACLAW_MODE=hybrid, LLM_PROVIDER=anthropic, HYBRID_ROUTING=auto. Ollama auto-detected if running.

Dependency Installation Reliability

  • fixRetry-safe npm install: 3 attempts with exponential backoff (2s, 5s, 10s). On each retry: npm cache clean, node_modules deletion.
  • fixpnpm fallback: if all 3 npm attempts fail, bootstrap falls back to pnpm install if available.
  • fixnpm install flags: --no-audit --no-fund --prefer-online applied globally.

Critical Bug Fix: Drizzle Migration 0005

  • fixMigration 0005 (share_tokens table) used bare semicolons. Added --> statement-breakpoint separators. Migration is idempotent.

Auto Dev Server + Browser Launch

  • featAfter setup, bootstrap automatically runs npm run dev and opens browser when server is ready.
  • feat120s timeout with graceful fallback message if server does not start in time.

v1.8.1

Stable2026-03-27

Knowledge Base Document Sharing: generate secure, expiring share links for any document in your Knowledge Base.

Secure Share Links

  • featcreateShareLink — generate UUID-based share tokens with permission (view/download), expiry, and optional access cap.
  • featrevokeShareLink — instantly invalidate any active share link.
  • featlistShareLinks — view all active shares per document with status badges.
  • fixPath traversal protection in getSharedDocument — all file reads sandboxed to ~/gigaclaw-docs/.

Share Dialog UI

  • featShareButton — one-click share trigger in the Knowledge Base document table row.
  • featShareDialog — modal with Create Link and Manage Links tabs.
  • featCopy-to-clipboard with visual confirmation.

v1.8.0

Stable2026-03-27

Knowledge Base: ingest documents, build vector embeddings, and let the AI agent answer questions grounded in your own data (RAG).

Knowledge Base Core

  • featDocument ingestion pipeline: upload PDF, Markdown, TXT, DOCX, or plain-text files.
  • featVector embedding with configurable chunk size and overlap.
  • featRAG-augmented chat: AI agent retrieves relevant chunks before answering.

Knowledge Base UI

  • featFull Knowledge Base page with document list, upload dialog, and search.
  • featDocument detail view with chunk preview and re-index controls.

v1.7.0

Stable2026-03-27

Connector Framework: pluggable data source connectors for Google Drive, Notion, Confluence, and GitHub.

  • featConnector registry with pluggable adapter pattern for external data sources.
  • featGoogle Drive connector — sync files and folders into the Knowledge Base.
  • featNotion connector — import pages and databases.
  • featConfluence connector — import spaces and pages.
  • featGitHub connector — import repository files and README.

v1.6.0

Stable2026-03-27

Tool Library: extensible tool system with built-in web search, calculator, and code execution tools.

  • featTool registry with dynamic tool loading and validation.
  • featBuilt-in tools: web search, calculator, code execution, file operations.
  • featCustom tool API for user-defined tools.

v1.5.0

Stable2026-03-27

Trust Ledger: immutable audit trail for all AI agent actions with cryptographic verification.

  • featTrust Ledger with SHA-256 hash chain for tamper-evident audit logging.
  • featTrust Ledger UI page with timeline view and verification controls.
  • featExport audit logs as JSON or CSV.

v1.4.0

Stable2026-03-27

Hybrid AI Router: intelligent routing between local (Ollama) and cloud (Anthropic/OpenAI/Google) models based on task complexity.

  • featHybrid AI Router with complexity-based routing between local and cloud models.
  • featAuto-routing mode: simple queries go to local Ollama, complex queries to cloud.
  • featManual routing override via chat command.
  • featRouter analytics in the dashboard.

v1.3.0

Stable2026-03-27

Notification system: in-app and Telegram notifications for job completions, errors, and system events.

  • featIn-app notification center with unread badges and mark-as-read.
  • featTelegram bot integration for push notifications.
  • featConfigurable notification preferences per event type.

v1.2.0

Stable2026-03-03

NPM package release: gigaclaw is now installable via npx gigaclaw init with interactive setup wizard.

  • featNPM package with npx gigaclaw init command.
  • featInteractive setup wizard for API keys and configuration.
  • featWeb chat interface with streaming responses.
  • featSwarm page for real-time job monitoring.
  • featAuthentication with NextAuth v5 and JWT sessions.

v1.1.0

Stable2026-03-03

Multi-LLM routing, India-first AI (PragatiGPT), local inference (Ollama), full Gignaati branding, and one-line cross-platform installers.

  • featAdded PragatiGPT provider — India-first Small Language Model for edge deployment.
  • featAdded Ollama provider for fully local AI inference.
  • featFull Gignaati branding applied across all templates and components.
  • featAdded install.sh (Linux/macOS) and install.ps1 (Windows) one-line installers.

v1.0.0

Initial2026-03-03

Initial public release of Gigaclaw — India's autonomous AI agent platform, built and maintained by Gignaati.

  • featFull Next.js 15 + React 19 web UI with streaming chat interface.
  • featGitHub Actions-native agent runner.
  • featDocker-based job execution with sandboxed environments.
  • featSQLite database with Drizzle ORM.

v1.2.x

NPM ReleaseFebruary 2026

gigaclaw is now an installable NPM package. Instead of forking a repo and wiring everything together yourself, you run one command and get a fully configured AI agent project.

Install in seconds

Run npx gigaclaw init and you have a working project.

Web chat interface

Chat with streaming responses, browse conversation history, upload images and PDFs.

Choose your LLM

Switch between Anthropic, OpenAI, and Google models by changing two environment variables.

Real-time Swarm view

See every active and completed job in real time.

Secure API key management

Keys are hashed with SHA-256 and verified with timing-safe comparison.

Production deployment built in

docker compose up gives you Traefik with automatic HTTPS and PM2.

Auto-upgrades

A GitHub Actions workflow can open a PR to upgrade your project when a new version is published.

Authentication out of the box

NextAuth v5 with JWT sessions. First visit creates an admin account.

Persistent conversations

All chats stored in SQLite via Drizzle ORM.

Breaking Changes

  • ×Fork-and-modify workflow — replaced by npx gigaclaw init
  • ×Express server in event_handler/ — replaced by Next.js route handlers
  • ×Single .env API key — replaced by database-backed key management
  • ×File-based JSON conversation history — replaced by SQLite database
  • ×Anthropic-only LLM support — replaced by multi-provider architecture
  • ×Manual deployment — replaced by Docker Compose with Traefik

Always on the latest version?

Run one command to upgrade any existing project.

npx gigaclaw@latest upgrade