by gradion-ai
General-purpose AI agent that acts via code actions through a unified execution interface.
# Add to your Claude Code skills
git clone https://github.com/gradion-ai/freeactLast scanned: 5/30/2026
{
"issues": [],
"status": "PASSED",
"scannedAt": "2026-05-30T16:21:39.795Z",
"npmAuditRan": true,
"pipAuditRan": true
}freeact is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by gradion-ai. General-purpose AI agent that acts via code actions through a unified execution interface. It has 128 GitHub stars.
Yes. freeact passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.
Clone the repository with "git clone https://github.com/gradion-ai/freeact" and add it to your Claude Code skills directory (see the Installation section above).
freeact is primarily written in Python. It is open-source under gradion-ai on GitHub, so you can review or fork the full source.
Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh freeact against similar tools.
No comments yet. Be the first to share your thoughts!
General-purpose AI agent that acts via code actions through a unified execution interface.
Freeact is a lightweight, general-purpose agent that acts via code actions in a stateful execution environment provided by ipybox. A unified execution interface allows code actions to contain any combination of Python code, shell commands, and programmatic MCP tool calls, generated in one LLM inference pass.
For programmatic MCP tool calling ("code mode"), freeact generates typed Python APIs from MCP server schemas. The agent inspects generated APIs prior to execution and composes them within code actions based on available type information. Successful code actions can be saved as reusable tools, capturing agent experience as executable knowledge, optionally combined with agent skills.
Freeact supports tool discovery via agentic and semantic search, loading only task-relevant tool information into the context window. It can enforce application-level approval of code actions, shell commands, and programmatic tool calls, originating from both main agents and subagents. Freeact runs locally on your computer and is available as a CLI tool and Python SDK.
[!NOTE] Supported models: Freeact supports any model compatible with Pydantic AI. See Configure models for provider configuration and examples.
| Capability | Description |
|---|---|
| Unified execution | Freeact agents act by executing Python code, shell commands, and programmatic MCP tool calls. These can be combined within a code action, generated in a single inference pass. |
| Action approval | Application-level approval of code actions, shell commands, and programmatic tool calls originating from both main agents and subagents. |
| MCP code mode | Freeact calls MCP server tools programmatically1) via generated Python APIs. This enables composition of tool calls and intermediate result processing in code actions, reducing LLM roundtrips. |
| Local execution | Freeact executes code and shell commands locally in an IPython kernel provided by ipybox. Data, configuration, and generated tools live in local workspaces. |
| Sandbox mode | IPython kernels optionally run in a sandbox environment based on Anthropic's sandbox-runtime, enforcing filesystem and network restrictions at OS level. |
| Tool discovery | Tools are discovered via category browsing or hybrid BM25/vector search. On-demand loading frees the context window and scales to larger tool libraries. |
| Subagent delegation | Tasks can be delegated to subagents, each using their own execution environment. This enables specialization and parallelization without cluttering the main agent's context. |
| Agent skills | agentskills.io-based skills add specialized knowledge and workflows, composing naturally with code actions and agent-authored tools. |
| Tool authoring | Agents can create new tools, enhance existing tools, and save code actions as reusable tools. This captures agent experiences as executable knowledge. |
| Session persistence | Freeact persists agent state incrementally. Persisted sessions can be resumed and serve as a record for debugging, evaluation, and improvement. |
| Component | Description |
|---|---|
| Agent SDK | Agent harness and Python API for building freeact applications. |
| CLI tool | Terminal interface for interactive conversations with a freeact agent. |
1) Freeact also supports MCP server integration via JSON tool calling, but the recommended approach is programmatic tool calling.