Skip to content

Repository files navigation

fallow
Agent skills for the fallow codebase intelligence layer for TypeScript and JavaScript.

MIT License CI Agent Skills fallow v3.22.0

Agent skills for fallow, codebase intelligence for TypeScript and JavaScript. The static layer reports quality, changed-code risk, cleanup opportunities, circular dependencies, code duplication, complexity hotspots, architecture boundary violations, and design-system styling drift in milliseconds. Optional runtime intelligence adds production execution evidence so agents can delete cold code, flag hot-path changes, and retire stale flags with proof. Broad framework plugin coverage, zero configuration. Works with any agent that supports the Agent Skills specification: Claude Code, Cursor, OpenAI Codex, Windsurf, GitHub Copilot, Gemini CLI, Amp, and 30+ more. See Fallow for coding agents for the visual overview and store links.

Linters enforce style. Formatters enforce consistency. Fallow enforces relevance. Linters work file by file. TypeScript works type by type. Neither builds the full module graph, so neither can see what nothing depends on. Fallow does, in milliseconds. These skills teach agents how to use fallow effectively: which commands to run, what flags to use, how to interpret output, and how to avoid common pitfalls.

Quick Start

Agent Skills CLI

npx skills add fallow-rs/fallow-skills

Claude Code

/plugin marketplace add fallow-rs/fallow-skills
/plugin install fallow@fallow-skills

OpenAI Codex

codex plugin marketplace add fallow-rs/fallow-skills
codex plugin add fallow@fallow-skills

Fallow Impact statusline

Claude Code users can add the compact Fallow Impact segment to their statusline:

/fallow:impact-statusline setup user compose

The command doc covers status, remove, and the project scope. Other agents render the same line with fallow impact statusline.

Agent-specific CLI shortcuts

npx skills add fallow-rs/fallow-skills --agent windsurf
npx skills add fallow-rs/fallow-skills --agent amp
gemini skills install https://github.com/fallow-rs/fallow-skills.git
Other agents

Use npx skills add fallow-rs/fallow-skills --all for installer-managed discovery, or copy the directories under fallow/skills/ into your agent's skills location.

Prerequisites

Fallow must be installed in the target project:

npm install -g fallow    # prebuilt binaries
npx fallow                   # or run without installing

See the installation guide for all options including cargo install fallow-cli.

Privacy and network behavior

Analysis runs locally by default and telemetry is off unless the user opts in. The plugin README lists the exact network, telemetry, and statusline behavior for the Claude Code and Codex surfaces.

Available Skills

Skill Description Trigger phrases
fallow Codebase intelligence for JS and TS, code and styles: quality, changed-code risk, cleanup opportunities, circular deps, duplication, complexity, design-system drift, and runtime evidence "check code health", "audit this PR", "find cleanup opportunities", "find duplicates", "what code actually runs"
fallow-review Graph-grounded review of changed-code risk, blast radius, and consequential structural decisions "review this branch", "review this PR", "check changed code before merge"

Reference Documentation

  • CLI Reference: all commands, flags, JSON output structure, config format
  • Gotchas: common pitfalls with WRONG/CORRECT examples
  • Patterns: workflow recipes for CI, monorepos, migration, and incremental adoption

Contributing

See AGENTS.md for repository structure and quality standards. The fallow skill is vendored byte-for-byte from the fallow source repository at the commit pinned in source-lock.json; CI checks that pin against a clean source checkout and rejects contract or privacy-boundary drift. Maintainers can find the versioning, packaging, and store update procedure in RELEASING.md.

Enable the commit hook

A fresh clone runs no hooks. Turn them on once per clone:

git config core.hooksPath .githooks

The hook only checks manifest version agreement and the bump rule; see .githooks/pre-commit for why it stops there.

Related

License

MIT. See LICENSE for details.

About

Agent skills for fallow, codebase intelligence for TypeScript and JavaScript. Teaches AI agents how to find unused code, duplication, circular deps, complexity hotspots, architecture drift, design-system drift, and (with Fallow Runtime) hot-path and cold-path evidence. Works with Claude Code, Cursor, Codex, Gemini CLI, and 30+ agents.

Topics

Resources

Stars

119 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages