formax

Name: formax
Author: yusifeng

Verified

Terminal-first AI assistant for software engineering tasks (inspired by Claude Code v2.0.67)

191stars

7forks

TypeScript

Installation

# Add to your Claude Code skills
git clone https://github.com/yusifeng/formax

Getting Started

Guides for using ai agents skills like formax.

Caveman: Cut Claude Token Use by 65%
How agent-side prompt compression works, when to use it, and when not to.
What is an AI Skills Marketplace?
Definitions, how marketplaces work, and how to choose between them in 2026.
Getting Started with AI Skills

Security ReportVerified

Last scanned: 5/30/2026

{
  "issues": [],
  "status": "PASSED",
  "scannedAt": "2026-05-30T15:48:23.565Z",
  "npmAuditRan": false,
  "pipAuditRan": true
}

README.md

Frequently Asked Questions

What is formax?

formax is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by yusifeng. Terminal-first AI assistant for software engineering tasks (inspired by Claude Code v2.0.67). It has 191 GitHub stars.

Is formax safe to use?

Yes. formax 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.

How do I install formax?

Clone the repository with "git clone https://github.com/yusifeng/formax" and add it to your Claude Code skills directory (see the Installation section above).

What programming language is formax written in?

formax is primarily written in TypeScript. It is open-source under yusifeng on GitHub, so you can review or fork the full source.

Are there alternatives to formax?

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 formax against similar tools.

Agentic AI for Beginners

Build your first AI agent from scratch - tool use, ReAct pattern, memory, deployment

41 minBeginner

Comments (0)

to leave a comment.

No comments yet. Be the first to share your thoughts!

Related Skills

superpowers

by obra

An agentic skills framework & software development methodology that works.

234,966

agentseal pentest-ai

Formax

English | 简体中文

Formax is an open-source implementation of a Claude Code-style AI assistant for software engineering tasks, with both TUI and GUI workflows.

It is inspired by (but not affiliated with) Claude Code v2.0.67. Some behaviors are implemented by observation (for example, network traces) rather than upstream source code.

The project is currently in Beta and is better suited for learning, experimentation, and architecture study than stable production daily use.

Plan mode

/init（create CLAUDE.md）

Sub-agent and code review

Install

npm i -g @yusifeng/formax@beta

Quickstart

Start in your project directory:

cd /path/to/your/project
formax

On first run, Formax will prompt for missing credentials and runtime config.
If you want to run the guided setup first:

formax setup

Default config directory: ~/.formax/

GUI

formax web

Notes for formax web:

formax web requires setup credentials first. If missing, the command exits and asks you to run formax setup in terminal.
The Threads header always shows an Add project button.
In desktop clients (Electron), it opens a native folder picker and starts a thread in the selected project.
In browser-only mode, folder picking is not available; hovering the button shows Desktop only.

Advanced Modes (Optional)

formax app-server

Provides a JSON-RPC backend for GUI/IDE clients.

formax serve

Starts only the WebSocket bridge (typically for advanced debugging or split deployments).

Docs index: docs/index.md
Code navigation: CODEMAP.md

Current Gaps

Claude Code hooks support is still incomplete and under active development.
Tool execution behavior is not guaranteed to be fully identical to Claude Code. WebFetch and WebSearch currently have known stability and behavior gaps, and MCP is not supported in this version.
Formax Web is still relatively minimal today. The current UI direction is intentionally modeled after Codex.

Maintainer Notes

You will see .codex/skills, docs/, and plans/ in this repo. They can feel noisy, but they are intentionally kept as traces of AI-assisted development.
This project is built 100% with Codex. If you want to implement your own features, opening the repo in Codex gives useful context from those artifacts.
If there are features you want, please mention them in a PR. Ongoing Claude Code compatibility research may be prioritized first in upcoming iterations.

Safety & Limitations

Formax is experimental. Always review proposed commands and file changes before approval. You are responsible for modifications made in your environment.

At this stage, the project is better suited for learning, reverse-engineering, and experimentation than for stable production workflows.

Provider support status:

Anthropic and OpenAI-compatible paths are available in setup/runtime flows. Gemini is present in config surfaces but not fully supported in runtime execution yet.

License

MIT (see LICENSE).