> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fallow.tools/llms.txt
> Use this file to discover all available pages before exploring further.

# Fallow documentation

> Get started with Fallow: codebase intelligence for TypeScript and JavaScript. Free static analysis for unused code, duplication, complexity, and architecture drift. Optional runtime intelligence for hot paths, cold paths, and deletion confidence.

Fallow is **codebase intelligence for TypeScript and JavaScript**.

Use the free static layer to find unused code, duplication, complexity hotspots, architecture drift, and feature-flag branches across your module graph. Add the optional runtime layer when you want to know what actually executed in production.

<CardGroup cols={2}>
  <Card title="Static intelligence (free)" icon="diagram-project" href="/quickstart">
    MIT-licensed and open source. Understand how your code is wired.
  </Card>

  <Card title="Runtime intelligence (optional)" icon="chart-network" href="/explanations/static-vs-runtime">
    Paid team layer. Understand what actually ran in production.
  </Card>
</CardGroup>

## Start here

<Steps>
  <Step title="Run Fallow without installing">
    ```bash theme={null}
    npx fallow
    ```

    No config needed for the first run.
  </Step>

  <Step title="Read the three analyses">
    Dead code, duplication, and complexity, in one pass.
  </Step>

  <Step title="Go deeper">
    ```bash theme={null}
    npx fallow dead-code
    npx fallow dupes
    npx fallow health
    npx fallow fix --dry-run
    ```
  </Step>
</Steps>

## What Fallow helps you do

<CardGroup cols={2}>
  <Card title="Delete cold code" icon="trash" href="/analysis/dead-code">
    Remove unused files, exports, and dependencies with confidence.
  </Card>

  <Card title="Reduce duplication" icon="clone" href="/analysis/duplication">
    Find repeated logic before it spreads.
  </Card>

  <Card title="Prioritize refactors" icon="fire" href="/explanations/health">
    Use complexity and health analysis to focus cleanup work.
  </Card>

  <Card title="Add runtime evidence" icon="chart-network" href="/analysis/runtime-coverage">
    See hot paths, cold paths, and runtime-backed deletion evidence.
  </Card>
</CardGroup>

## Pick your workflow

<CardGroup cols={3}>
  <Card title="CLI" icon="terminal" href="/quickstart">
    Best place to start. Works locally, in CI, and in agent loops.
  </Card>

  <Card title="VS Code" icon="window" href="/integrations/vscode">
    Real-time diagnostics, Code Lens, and one-click fixes in the editor.
  </Card>

  <Card title="MCP and agents" icon="robot" href="/integrations/mcp">
    Structured tool calling for Claude Code, Cursor, and other agents.
  </Card>
</CardGroup>

## Understand the two layers

Static analysis answers: **what is connected to what?**

Runtime intelligence answers: **what actually ran?**

They meet in `fallow health`.

<Card title="Static vs runtime intelligence" icon="book-open" href="/explanations/static-vs-runtime">
  Read the mental model before you set up runtime collection.
</Card>

## Most-used pages

<CardGroup cols={2}>
  <Card title="Quick start" icon="rocket" href="/quickstart" />

  <Card title="Configuration" icon="gear" href="/configuration/overview" />

  <Card title="CI integration" icon="shield-check" href="/integrations/ci" />

  <Card title="CLI reference" icon="terminal" href="/cli/dead-code" />
</CardGroup>
