# Getting Started

## Installation

See the [Installation section in the README](https://github.com/sinelaw/fresh#installation) for all available installation methods, including Homebrew, AUR, .deb/.rpm packages, npm, crates.io, and building from source.





## Running Fresh

Run Fresh from the command line:

```bash
# Open an empty buffer
fresh

# Open a file
fresh src/main.rs

# Open a file at a specific line
fresh src/main.rs:42

# Open a file at a specific line and column
fresh src/main.rs:42:10

# Open multiple files (with optional line:col)
fresh Cargo.toml src/lib.rs:100:5

# Open a remote file via SSH (experimental)
fresh user@host:/path/to/file.txt

# Open a remote directory via SSH
fresh user@host:~/projects
```

The `file:line:col` syntax is useful for jumping directly to compiler errors or search results.

## Core Concepts

*   **The Command Palette:** The command palette provides quick access to commands and features. Press `Ctrl+P` to open it, and then start typing to search for commands.
*   **Buffers:** Each open file is represented as a buffer. You can have multiple buffers open at once and switch between them.
*   **Splits:** You can split your editor view horizontally or vertically to view multiple buffers at once.
*   **The Status Bar:** The status bar at the bottom of the screen displays information about the current buffer, including the file name, cursor position, and Git branch.
