Package Exports

clickforge

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (clickforge) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

⚒ ClickForge

Your own AI coding agent — a Claude-Code-style terminal assistant that reads, writes, and edits files and runs commands to build software. Powered by open models (gpt-oss), free to run on Groq's free tier, and 100% yours to brand and extend.

How it works

your request → model → model asks to use a tool → ClickForge runs it
            → model sees the result → repeats until the task is done

That loop is the whole "agent." The intelligence is the model (gpt-oss); the agent, tools, and branding are this repo (~400 lines, no heavy deps).

Setup

Get a free API key (no credit card): https://console.groq.com/keys
Set it:
```
setx GROQ_API_KEY "gsk_your_key_here"
```
Reopen your terminal afterward.
From any project folder:
```
clickforge
```

Commands

/help — show help
/clear — reset the conversation
/cwd — show working directory
/exit — quit

Tools the agent can use

list_files, read_file, write_file, edit_file, run_command (shell commands ask for confirmation unless you set CLICKFORGE_YOLO=1).

Configuration (all optional env vars)

Var	Default	Purpose
`GROQ_API_KEY`	—	API key
`CLICKFORGE_MODEL`	`openai/gpt-oss-120b`	model id
`CLICKFORGE_BASE_URL`	`https://api.groq.com/openai/v1`	any OpenAI-compatible endpoint
`CLICKFORGE_YOLO`	`0`	`1` = run commands without asking

Upgrade path: to use your own GPU server or a paid endpoint later, just change CLICKFORGE_BASE_URL + CLICKFORGE_API_KEY. No code changes.

Project layout

bin/clickforge.js   entry point
src/config.js       model + endpoint config
src/ui.js           branding, colors, spinner
src/tools.js        tool schemas + implementations
src/agent.js        the agent loop + REPL

Extend it

Add a tool: add a schema to toolSchemas and a case in runTool (src/tools.js).
Change personality/rules: edit systemPrompt() in src/agent.js.
Rebrand: edit BRAND in src/config.js and banner() in src/ui.js.