vasilysahrai

Freeagent — AI skill for Claude Code

AI community

FreeAgent — a free, open-source terminal coding agent, Claude Code-style, powered by z.ai's free GLM APIs.

How to install Freeagent

This entry records only its repository, not the path inside it, so there is no exact command to give. Open vasilysahrai/freecode and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Freeagent does

FreeAgent — a free, open-source terminal coding agent, Claude Code-style, powered by z.ai's free GLM APIs. Ships to GitHub and Vercel.

Alternatives in AI

  • WindsurfAPI — Turn Windsurf / Devin Desktop's 100+ AI models (Claude, GPT, Gemini, DeepSeek, Kimi, GLM, SWE) into OpenAI-, A 3k ★
  • Coding Agent Template — Multi-agent AI coding platform powered by Vercel Sandbox and AI Gateway 1.8k ★
  • Paca — AI-native, free, open-source alternative to Jira, Trello, ClickUp & Monday 1.8k ★

README

FreeAgent

An open-source terminal coding agent. One CLI, swappable models — free (z.ai GLM-4.5-flash, Groq, OpenRouter `:free` routes, local Ollama) or paid frontier (GPT-5, Claude Opus 4.5, Gemini 2.5 Pro). It reads and edits your code, runs commands, and ships projects to GitHub and Vercel.

MIT licensed. Built by [Vasily Sahrai](https://github.com/vasilysahrai).


Install

macOS & Linux

curl -fsSL https://raw.githubusercontent.com/vasilysahrai/freeagent/main/install.sh | bash

Windows (PowerShell)

irm https://raw.githubusercontent.com/vasilysahrai/freeagent/main/install.ps1 | iex

Both installers detect Python, prefer `pipx`, and warn if the resulting binary isn't on `PATH`.


Pick a model

freeagent --list-models       # full catalog with free/paid/local tags
freeagent --list-providers
freeagent --list-keys         # which provider keys you have set
freeagent --deps              # gh / vercel / git availability

Free (no per-token cost)

Provider Model Notes
z.ai glm-4.5-flash Free tier. Solid default.
Groq llama-3.3-70b-versatile Free, very fast, rate-limited.
Groq deepseek-r1-distill-llama-70b Free reasoning model.
OpenRouter deepseek/deepseek-r1:free Free :free route.
Google Gemini gemini-2.5-flash Free quota in AI Studio.

Local (zero cost, your hardware)

`ollama pull qwen2.5-coder:7b` — runs on most laptops with 16 GB RAM.

Paid (frontier)

OpenAI `gpt-5` / `gpt-4o`, Anthropic `claude-opus-4-5` / `claude-sonnet-4-5`, Google `gemini-2.5-pro`, xAI `grok-3`, Mistral `mistral-large-latest`, z.ai `glm-4.6`.


Configure

Set whichever key you actually plan to use, in your shell rc or in `~/.freeagent/.env`:

export ZAI_API_KEY=...        # free        — https://z.ai
export GROQ_API_KEY=...       # free tier   — https://console.groq.com/keys
export OPENROUTER_API_KEY=... # fre