> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.com/sinelaw/fresh/llms.txt
> Use this file to discover all available pages before exploring further.

# Fresh - Modern Terminal Text Editor

> A full-featured terminal text editor with zero configuration. Familiar keybindings, mouse support, and IDE-level features — no learning curve required.

<img className="block" src="https://mintlify.s3.us-west-1.amazonaws.com/sinelaw-fresh/images/fresh-hero.png" alt="Fresh Text Editor" />

## Welcome to Fresh

Fresh brings the intuitive UX of VS Code and Sublime Text to the terminal. Standard keybindings, full mouse support, menus, and a command palette — everything works the way you'd expect, right out of the box. **No modes, no memorizing shortcuts.**

Built for real-world performance: Fresh handles multi-gigabyte files with negligible memory overhead and delivers consistently low-latency input, regardless of file size.

<CardGroup cols={2}>
  <Card title="Installation" icon="download" href="/installation">
    Get started with Fresh using your preferred package manager
  </Card>

  <Card title="Quick Start" icon="rocket" href="/quickstart">
    Learn the basics in 5 minutes with our interactive tutorial
  </Card>

  <Card title="Features" icon="sparkles" href="/features/editing">
    Explore multi-cursor editing, LSP support, and more
  </Card>

  <Card title="Configuration" icon="gear" href="/configuration/overview">
    Customize themes, keybindings, and editor settings
  </Card>
</CardGroup>

## Why Fresh?

<AccordionGroup>
  <Accordion title="Zero Configuration" icon="bolt">
    Fresh works perfectly out of the box. No configuration files to edit, no plugins to install. Start editing immediately with sensible defaults that just work.
  </Accordion>

  <Accordion title="Familiar Experience" icon="hand">
    If you've used VS Code, Sublime Text, or any modern editor, you already know Fresh. Standard keybindings (`Ctrl+C`, `Ctrl+V`, `Ctrl+F`, etc.) work exactly as expected.
  </Accordion>

  <Accordion title="High Performance" icon="gauge-high">
    Edit multi-gigabyte files with ease. Fresh uses advanced memory mapping and lazy loading techniques to handle massive files with minimal memory overhead.
  </Accordion>

  <Accordion title="Full Mouse Support" icon="computer-mouse">
    Click to position the cursor, drag to select, scroll with your mouse wheel. Fresh supports all the mouse interactions you're used to in graphical editors.
  </Accordion>

  <Accordion title="IDE-Level Features" icon="code">
    Language Server Protocol (LSP) integration provides go-to-definition, autocomplete, diagnostics, hover documentation, and code actions — all in your terminal.
  </Accordion>

  <Accordion title="Extensible" icon="puzzle-piece">
    Write plugins in TypeScript using a sandboxed QuickJS runtime. Extend Fresh with custom commands, UI overlays, language support, and more.
  </Accordion>
</AccordionGroup>

## Key Features at a Glance

<CardGroup cols={3}>
  <Card title="Command Palette" icon="terminal">
    One shortcut (`Ctrl+P`) to find files, run commands, switch buffers, and jump to any line
  </Card>

  <Card title="Multi-Cursor Editing" icon="arrows-to-dot">
    Select and edit multiple occurrences simultaneously with `Ctrl+D`
  </Card>

  <Card title="File Explorer" icon="folder-tree">
    Built-in sidebar with gitignore support and fuzzy file search
  </Card>

  <Card title="Split Panes" icon="table-columns">
    View multiple files side-by-side with horizontal and vertical splits
  </Card>

  <Card title="Integrated Terminal" icon="square-terminal">
    Run shell commands without leaving the editor
  </Card>

  <Card title="Git Integration" icon="code-branch">
    Git grep, file finder, and branch display in status bar
  </Card>

  <Card title="Themes" icon="palette">
    Browse and apply color themes instantly with built-in theme selector
  </Card>

  <Card title="Remote Editing" icon="cloud">
    Edit files on remote servers via SSH (experimental)
  </Card>

  <Card title="Session Persistence" icon="floppy-disk">
    Detach and reattach to editing sessions (experimental)
  </Card>
</CardGroup>

## Complete Feature Set

| Category                  | Features                                                                                                             |
| ------------------------- | -------------------------------------------------------------------------------------------------------------------- |
| **File Management**       | open/save/new/close, file explorer, tabs, auto-revert, git file finder                                               |
| **Editing**               | undo/redo, multi-cursor, block selection, smart indent, comments, clipboard                                          |
| **Search & Replace**      | incremental search, find in selection, query replace, git grep                                                       |
| **Navigation**            | go to line/bracket, word movement, position history, bookmarks, error navigation                                     |
| **Views & Layout**        | split panes, line numbers, line wrap, backgrounds, markdown preview                                                  |
| **Language Server (LSP)** | go to definition, references, hover, code actions, rename, diagnostics, autocompletion                               |
| **Productivity**          | command palette, menu bar, keyboard macros, git log, diagnostics panel                                               |
| **Extensibility**         | TypeScript plugins (sandboxed QuickJS), color highlighter, TODO highlighter, merge conflicts, path complete, keymaps |
| **Internationalization**  | Multiple language support with plugin translation system                                                             |

## Quick Start

Get Fresh up and running in seconds:

<CodeGroup>
  ```bash macOS/Linux (curl) theme={null}
  curl https://raw.githubusercontent.com/sinelaw/fresh/refs/heads/master/scripts/install.sh | sh
  ```

  ```bash macOS (Homebrew) theme={null}
  brew tap sinelaw/fresh
  brew install fresh-editor
  ```

  ```bash Windows (winget) theme={null}
  winget install fresh-editor
  ```

  ```bash npm theme={null}
  npm install -g @fresh-editor/fresh-editor
  ```

  ```bash Cargo theme={null}
  cargo install fresh-editor
  ```
</CodeGroup>

Once installed, simply run:

```bash theme={null}
fresh
```

<Tip>
  Visit the [Installation](/installation) page for all available installation methods, or jump to the [Quick Start](/quickstart) guide to learn the basics.
</Tip>

## Community & Support

<CardGroup cols={3}>
  <Card title="GitHub" icon="github" href="https://github.com/sinelaw/fresh">
    Star the project and report issues
  </Card>

  <Card title="Discord" icon="discord" href="https://discord.gg/gqGh3K4uW3">
    Join the community chat
  </Card>

  <Card title="Documentation" icon="book" href="https://getfresh.dev/docs">
    Browse the full documentation
  </Card>
</CardGroup>

## Open Source

Fresh is open source software licensed under GPL-2.0. Contributions are welcome! See the [Contributing Guide](https://github.com/sinelaw/fresh/blob/master/CONTRIBUTING.md) to get started.

<Note>
  Fresh checks for new versions daily to notify you of available upgrades. It sends basic anonymous telemetry (version, OS/architecture, terminal type) to help understand usage patterns. No personal data or file contents are collected. Disable with `--no-upgrade-check` or set `check_for_updates: false` in your config.
</Note>