1 # siGit Code
2
3 <p align="center">
4 <a href="https://crates.io/crates/sigit"><img src="https://img.shields.io/crates/v/sigit?style=flat-square&labelColor=17211D&color=235843" alt="Crates.io"></a>
5 <a href="https://pypi.org/project/sigit-code/"><img src="https://img.shields.io/pypi/v/sigit-code?style=flat-square&labelColor=17211D&color=235843" alt="PyPI"></a>
6 <a href="https://www.npmjs.com/package/@smbcloud/sigit"><img src="https://img.shields.io/npm/v/@smbcloud/sigit?style=flat-square&labelColor=17211D&color=235843" alt="npm"></a>
7 <a href="https://smbcloud.xyz"><img src="https://img.shields.io/badge/smbcloud.xyz-235843?style=flat-square&labelColor=17211D" alt="Website"></a>
8 <a href="https://github.com/getsigit/sigit/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-Apache--2.0-235843?style=flat-square&labelColor=17211D" alt="License"></a>
9 </p>
10
11 siGit Code is a local coding agent. It runs on your machine, not someone else's. No API keys, no cloud round-trips, no subscription.
12
13 Its home is [code.sigit.si](https://code.sigit.si). You can run it yourself, as below, or use the hosted version (siGit Code Cloud) there if you would rather not run a model locally. [sigit.si](https://sigit.si) is Git hosting built for AI workflows.
14
15 It works in any codebase. In smbCloud repos it is more useful out of the box because it already understands the Rust workspace layout, deploy flows, auth boundaries, and GresIQ.
16
17 You can use it in two ways:
18
19 - **ACP mode:** Zed or another ACP-compatible editor starts it over stdio
20 - **Terminal mode:** run `sigit` for the interactive chat UI
21
22 | Platform | ACP mode | Terminal mode |
23 |----------|----------|---------------|
24 | macOS | ✓ | ✓ |
25 | Linux | ✓ | ✓ |
26 | Windows | ✓ | not yet |
27
28 ## Install
29
30 ```sh
31 cargo install sigit
32 ```
33
34 | Method | Command |
35 |--------|---------|
36 | Homebrew | `brew tap getsigit/tap && brew install sigit` |
37 | pip | `pip install sigit-code` |
38 | uv | `uvx --from sigit-code sigit` |
39 | npm | `npm install -g @smbcloud/sigit` |
40
41 ## First run
42
43 The first launch downloads a GGUF model from Hugging Face. Expect roughly 1 to 2 GB, depending on the model. After that, loads come from disk and are much faster.
44
45 On macOS, siGit Code shares its model cache with the desktop app through an App Group container. If the desktop app already downloaded the model, the CLI reuses it.
46
47 ## Zed setup
48
49 Add this to `~/.config/zed/settings.json`:
50
51 ```json
52 {
53 "agent_servers": {
54 "siGit Code": {
55 "type": "custom",
56 "command": "/absolute/path/to/sigit"
57 }
58 }
59 }
60 ```
61
62 Use the full absolute path. `~` does not expand here.
63
64 ## VS Code
65
66 ### With siGit Code Extension
67
68 Install from the [Visual Studio Code Marketplace](https://marketplace.visualstudio.com/items?itemName=getsigit.sigit-code).
69
70 ```jsonc
71 {
72 "sigit.agents": {
73 "sigit": {
74 "name": "siGit (on-device)",
75 "command": "sigit",
76 "args": [],
77 "env": {}
78 },
79 },
80 "sigit.agent.default": "sigit"
81 }
82 ```
83
84 ### With ACP Client
85
86 Install [ACP Client](https://marketplace.visualstudio.com/items?itemName=formulahendry.acp-client), then add:
87
88 ```json
89 {
90 "acp.agents": {
91 "siGit Code": {
92 "command": "sigit",
93 "args": [],
94 "env": {}
95 }
96 }
97 }
98 ```
99
100 ## Terminal mode
101
102 Run `sigit` in a terminal and you get the same model and system prompt as the editor integration, just in a full-screen chat UI.
103
104 Terminal mode currently needs Unix terminal behavior, so it works on macOS and Linux only.
105
106 ## Platform support
107
108 | Platform | Architecture |
109 |----------|-------------|
110 | macOS | arm64, x64 |
111 | Linux (glibc) | arm64, x64 |
112 | Windows | arm64, x64 |
113
114 ## License
115
116 [Apache 2.0](https://github.com/getsigit/sigit/blob/main/LICENSE)
117
118 ## Copyright
119
120 © 2026 [Splitfire AB](https://5mb.app) ([siGit Code & Deploy](https://sigit.si)).