Autonomous AI Coding Agent — No API Key Needed
Forge Agent drives DeepSeek, ChatGPT, or Gemini through browser automation to code, test, and ship software — completely free.
Forge Agent is free and open source. If it saves you time:
- Free — No API key. Uses DeepSeek, ChatGPT, or Gemini's free web UI.
- Autonomous — Reads files, writes code, runs tests. Loops until done.
- Cross-platform — Linux, macOS, Windows, and Docker.
- 50 days built — 37+ tools, 1300+ tests, full docs, security audited.
# npm (recommended)
npm install -g @omar-azam/forge-agent
# Docker (no Node.js required)
docker pull ghcr.io/omar-azam/forge-agent:latest# First time setup
forge-agent --setup
# Run a task
forge-agent "build a REST API with Express and JWT auth"
# Interactive mode — multiple tasks, shared context
forge-agent --interactive
# Short alias
fa "add TypeScript to this project"| Feature | Description |
|---|---|
| 🌐 Browser Automation | Drives DeepSeek, ChatGPT, Gemini — no API key |
| 🔧 37+ Built-in Tools | File I/O, git, shell, search, tests, packages, diff, env, processes |
| 💾 Persistent Memory | Remembers project tech stack and past tasks |
| 🎭 Agent Profiles | default, backend, frontend, data-science, devops |
| 📋 Task Templates | 10 built-in templates — add TypeScript, Jest, Docker in one command |
| 🔄 Session Resume | Continue tasks that stopped halfway |
| 👁 Watch Mode | Auto re-run on file changes |
| 🔌 Custom Plugins | Drop a .js file to add any tool |
| 🔒 Security Sandbox | Blocks SSH keys, credentials, path traversal |
| 🐳 Docker Ready | Official image, no local Node.js setup needed |
| ⚡ Smart Caching | Skips repeated read-only tool calls |
| 🗜 Context Compression | Auto-compresses long conversations |
| 📊 Benchmarks | Measure and compare performance |
File: read_file · write_file · append_to_file · replace_in_file · delete_file · move_file · copy_file · create_directory · list_directory · get_file_info · write_files
Search: search_in_files · search_codebase · find_files
Shell: run_command · start_process · stop_process · list_processes · read_process_logs
Git: git_status · git_log · git_diff · git_branches · git_show · git_blame
Dev: run_tests · install_package · diff_files · patch_file
Env: read_env · set_env_var · delete_env_var · list_env_files · check_env_vars
System: take_screenshot · read_clipboard · write_clipboard
forge-agent --profile=backend # Node.js, Python, Go, REST APIs
forge-agent --profile=frontend # React, Vue, HTML/CSS
forge-agent --profile=data-science # Python, pandas, ML
forge-agent --profile=devops # Docker, CI/CD, shell scriptsforge-agent --template=add-typescript # Add TypeScript to any JS project
forge-agent --template=add-jest # Set up Jest testing
forge-agent --template=add-docker # Dockerfile + docker-compose
forge-agent --template=add-github-actions # CI/CD pipeline
forge-agent --template=fix-tests # Run and fix all failing tests
forge-agent --template=code-review # Comprehensive code review
forge-agent --list-templates # See all 10 templatesforge-agent --history # Browse past tasks
forge-agent --resume # Pick and resume a past task
forge-agent --resume=last # Resume most recent task immediately
forge-agent --rerun # Re-run most recent task fresh# Single task
docker run --rm -v "$(pwd):/workspace" --network host \
ghcr.io/omar-azam/forge-agent "build a REST API"
# Interactive
docker run --rm -it -v "$(pwd):/workspace" --network host \
ghcr.io/omar-azam/forge-agent --interactive
# With Make
make run TASK="build a REST API"
make interactive// ~/.deepseek-agent/tools/fetch_weather.js
module.exports = {
name: 'fetch_weather',
description: 'Get current weather for a city',
parameters: { city: { type: 'string', required: true } },
async execute({ city }) {
const https = require('https');
return new Promise((res, rej) => {
https.get(`https://wttr.in/${city}?format=3`, r => {
let d = ''; r.on('data', c => d += c); r.on('end', () => res(d));
}).on('error', rej);
});
},
};forge-agent --list-plugins # see all loaded plugins
forge-agent --new-plugin my_tool # generate a stubforge-agent [OPTIONS] [TASK]
Core: --interactive -i --dir --model --profile --plan --think
Sessions: --resume --rerun --history --no-memory
Templates: --template --list-templates --save-template
Output: --format --output --no-tui --compact
Watch: --watch --watch-pattern --watch-debounce
Performance: --max-iterations --timeout --no-timeout
Plugins: --list-plugins --new-plugin
Config: --setup --config-path
Debug: --debug --headless --diagnostics --security
Help: --help --help=<topic> --cheatsheet --man
Full reference: forge-agent --help or docs/cli-reference.html
// ~/.deepseek-agent/config.json
{
"MODEL": "deepseek",
"MAX_ITERATIONS": 100,
"RESPONSE_TIMEOUT": 600000,
"ACTIVE_PROFILE": "default",
"MEMORY_ENABLED": true,
"CACHE_ENABLED": true
}Run forge-agent --setup for guided configuration.
- 🔧 37+ tools built in
- 🧪 1300+ tests across 49 suites
- 📁 13 docs pages including full CLI reference
- 📋 10 task templates built in
- 💡 10 example projects in gallery
- ⚙️ 40+ CLI flags
- 🐳 Docker image published
- 🔒 Security audited with path sandbox
- 📦 50 days of development
Full documentation: https://omar-azam.github.io/forge-agent
- Getting Started
- All Tools
- CLI Reference
- Agent Profiles
- Task Templates
- Custom Plugins
- Docker Guide
- Configuration
- Security
- Examples Gallery
See CONTRIBUTING.md for development setup, code style, and how to add new tools.
All contributions welcome: new tools, bug fixes, docs improvements, new templates, plugin examples.
Forge Agent is free and open source. If it saves you time:
- ⭐ Star the repo — helps others discover it
- 💰 Sponsor development
- 📢 Share it — post about it, tell your team
- 🐛 Report bugs — good reports make it better
- 📝 Improve docs — any PR helps
MIT — see LICENSE