Forge Logo

Cognautic Forge

Local-first AI co-worker CLI for agentic development and automation.

Stable npm package

Overview

Cognautic Forge is a terminal-native AI workspace with multi-provider models, tool-calling, persistent memory, and controlled execution modes.

  • Local-first execution
  • Interactive chat + command mode
  • Provider/model switching
  • Resumable chats and workspace state
  • Google Workspace login and direct Google tools

Install

Recommended (npm global)

npm i -g @cognautic.space/forge

Run without global install

npx @cognautic.space/forge

Update Instructions

Update Forge to the latest published version with npm:

npm i -g @cognautic.space/forge@latest

If you use npx, no global update is required. This always runs the latest package:

npx @cognautic.space/forge@latest

Open Forge

After installation, open a terminal and run:

forge

Or run directly with npx:

npx @cognautic.space/forge

Resume an old chat:

forge resume <chat-id-or-name>

Show help:

forge help

Quick Start

  1. Run forge
  2. Set provider: /provider openai
  3. Set key: /apikey <provider> <api-key>
  4. Fetch models: /models refresh
  5. Select model: /model <model-id>
  6. Ask task: build me a plan to ...

Providers & Models

Supported providers:

  • OpenAI
  • NVIDIA NIM
  • Google
  • Anthropic
  • OpenRouter
  • Groq
  • Cerebras
  • Ollama
  • Custom OpenAI-compatible endpoint

Common provider/model commands:

/providers /provider <openai|nim|google|anthropic|openrouter|groq|cerebras|ollama|custom> /models /models refresh /model <model-id> /endpoint <url>

Execution Modes

safe: approval for sensitive actions.

yolo: auto-executes actions.

/mode <safe|yolo> /yolo [on|off|toggle]

Google Login

Users sign in to Google directly from Forge. Local Google client id and client secret setup is not required for normal use.

forge auth google forge logout google

Inside chat:

/auth google /logout google

After login, Forge can use Google tools for Gmail, Calendar, Drive, Docs, Sheets, Tasks, Contacts, and Meet.

Slash Commands

/help /status /config /provider <provider> /model <model-id> /models [refresh] /apikey <provider> <api-key> /endpoint <url> /root <path> /browserpath </path/to/browser> /searchmode <safe|manual> /auth google /logout google /yolo [on|off|toggle]

CLI Commands

forge state show forge state set-root <path> forge state set-browser </usr/sbin/brave> forge provider show forge provider set <provider> <model> [--endpoint URL] forge provider key set <provider> <api-key> forge provider models [provider] forge auth google forge logout google forge chat <prompt> forge workspace show forge workspace objective <text> forge workspace task <add|list|set> ... forge browser launch --executable /usr/sbin/brave

Google Tools

Available Google tool groups in Forge:

  • Gmail: list, read, send, draft, reply, search, labels, move/label
  • Calendar: list events, create, update, delete, get, list calendars, free slots
  • Drive: list, search, get, upload, create folder, delete, move, share
  • Docs: create, read, append text, replace text
  • Sheets: create, read range, write range, append row, get all
  • Tasks: list, create, complete, delete, list task lists
  • Contacts: search, get, list, create
  • Meet: create meetings

Keybinds

  • Ctrl+Y: Toggle yolo mode
  • Esc: Stop current AI response
  • Tab / Right Arrow / End: autocomplete suggestions
  • Shift+Tab: Toggle chat mode / shell mode

Troubleshooting

Command not found: forge

Open a new terminal, or ensure install path is in PATH.

Provider errors / 401

Check API key and provider selection with /provider and /apikey.

No models listed

Run /models refresh and verify network/provider endpoint.

Browser closed errors

Use /browserpath and relaunch browser tools.