blob: 618704eb34c599603c42d0c2c7852470b8450a57 [file] [log] [blame] [view]
Earl Lee2e463fb2025-04-17 11:22:22 -07001# Sketch
2
Philip Zeyliger3b279a52025-05-07 21:02:03 -07003Sketch is an agentic coding tool.
4
5Sketch runs in your terminal, has a web UI, understands your code, and helps
6you get work done. To keep your environment pristine, sketch starts a docker
7container and outputs its work onto a branch in your host git repository.
8
9Sketch helps with most programming environments, but Go is Sketch's specialty.
Earl Lee2e463fb2025-04-17 11:22:22 -070010
David Crawshaw64d32992025-04-21 09:14:36 -070011To get started:
Earl Lee2e463fb2025-04-17 11:22:22 -070012
13```sh
14go install sketch.dev/cmd/sketch@latest
15sketch
16```
David Crawshaw64d32992025-04-21 09:14:36 -070017
18## Requirements
19
Josh Bleecher Snyder5cef9db2025-04-22 16:44:13 -070020Currently sketch runs on macOS and linux.
David Crawshawab50e9b2025-05-03 10:26:42 -070021It uses docker for containers.
Josh Bleecher Snyder5cef9db2025-04-22 16:44:13 -070022
David Crawshawab50e9b2025-05-03 10:26:42 -070023macOS: `brew install colima` (or an equivalent, like Docker Desktop or Orbstack)
Josh Bleecher Snyder5cef9db2025-04-22 16:44:13 -070024linux: `apt install docker.io` (or equivalent for your distro)
David Crawshawab50e9b2025-05-03 10:26:42 -070025WSL2: install Docker Desktop for Windows (docker entirely inside WSL2 is tricky)
David Crawshaw64d32992025-04-21 09:14:36 -070026
27The [sketch.dev](https://sketch.dev) service is used to provide access
28to an LLM service and give you a way to access the web UI from anywhere.
29
30## Feedback/discussion
31
32We have a discord server to discuss sketch.
33
David Crawshawdf6d7b42025-05-06 09:56:07 -070034Join if you want! https://discord.gg/6w9qNRUDzS
David Crawshaw64d32992025-04-21 09:14:36 -070035
Philip Zeyligerd43e5722025-04-23 19:21:26 -070036## Development
37
M-Ab5cb9542025-05-02 11:32:34 -040038[![Go Reference](https://pkg.go.dev/badge/sketch.dev.svg)](https://pkg.go.dev/sketch.dev)
39
Pokey Rulebbca2402025-04-24 09:37:58 +010040See [CONTRIBUTING.md](CONTRIBUTING.md)
Philip Zeyligerd43e5722025-04-23 19:21:26 -070041
David Crawshaw64d32992025-04-21 09:14:36 -070042## Open Source
43
44Sketch is open source.
45It is right here in this repository!
46Have a look around and mod away.
47
48If you want to run sketch entirely without the sketch.dev service, you can
Philip Zeyligerd43e5722025-04-23 19:21:26 -070049set the flag -skaband-addr="" and then provide an `ANTHROPIC_API_KEY`
David Crawshaw64d32992025-04-21 09:14:36 -070050environment variable. (More LLM services coming soon!)