---
title: Quick Start
description: Get up and running with Kit in minutes.
---

# Quick Start

## Basic usage

Start an interactive session:

```bash
kit
```

Run a one-off prompt:

```bash
kit "List files in src/"
```

Attach files as context using the `@` prefix:

```bash
kit @main.go @test.go "Review these files"
```

Use a specific model:

```bash
kit --model anthropic/claude-sonnet-latest
```

## Non-interactive mode

Kit can run as a non-interactive tool for scripting and automation.

Get JSON output:

```bash
kit "Explain main.go" --json
```

Quiet mode (final response only, no TUI):

```bash
kit "Run tests" --quiet
```

Ephemeral mode (no session file created):

```bash
kit "Quick question" --no-session
```

## Resuming sessions

Continue the most recent session for the current directory:

```bash
kit --continue
# or
kit -c
```

Pick from previous sessions interactively:

```bash
kit --resume
# or
kit -r
```

## ACP server mode

Kit can run as an [ACP (Agent Client Protocol)](https://agentclientprotocol.com) agent server, enabling ACP-compatible clients (such as [OpenCode](https://github.com/sst/opencode)) to drive Kit as a remote coding agent over stdio:

```bash
# Start Kit as an ACP server (JSON-RPC 2.0 on stdin/stdout)
kit acp

# With debug logging to stderr
kit acp --debug
```

The ACP server exposes Kit's full capabilities — LLM execution, tool calls (bash, read, write, edit, grep, etc.), and session persistence — over the standard ACP protocol.
