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/@getsigit/sigit"><img src="https://img.shields.io/npm/v/@getsigit/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 trust --tap getsigit/tap && brew install sigit` |
37 | pip | `pip install sigit-code` |
38 | uv | `uvx --from sigit-code sigit` |
39 | npm | `npm install -g @getsigit/sigit` |
40 | NuGet | `dotnet tool install --global SiGit.Code` |
41 | winget | `winget install smbCloud.siGitCode` |
42 | Scoop | `scoop bucket add getsigit https://github.com/getsigit/scoop-bucket && scoop install sigit` |
43 | AUR | `yay -S sigit-bin` |
44 | Debian/Ubuntu | download the `.deb` from [releases](https://github.com/getsigit/sigit/releases), then `sudo dpkg -i sigit_*.deb` |
45 | Fedora/RHEL | download the `.rpm` from [releases](https://github.com/getsigit/sigit/releases), then `sudo rpm -i sigit-*.rpm` |
46
47 ## First run
48
49 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.
50
51 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.
52
53 ## Zed setup
54
55 Add this to `~/.config/zed/settings.json`:
56
57 ```json
58 {
59 "agent_servers": {
60 "siGit Code": {
61 "type": "custom",
62 "command": "/absolute/path/to/sigit"
63 }
64 }
65 }
66 ```
67
68 Use the full absolute path. `~` does not expand here.
69
70 ## Xcode custom agent
71
72 In Xcode, open **Settings > Intelligence > Agents**, add a custom agent, and set:
73
74 - **Executable:** the absolute path to `sigit`
75 - **Arguments:** `--acp`
76
77 The explicit `--acp` mode is designed for Xcode: it loads the selected on-device
78 model on the first prompt, so you do not need to send `/load` from the Xcode chat.
79
80 To let siGit use Xcode's build, test, and project tools, enable **Allow external
81 agents to use Xcode tools** in Xcode's Intelligence settings, keep the project
82 open, and add this to `~/.config/sigit/mcp.toml`:
83
84 ```toml
85 [[server]]
86 name = "xcode"
87 command = "xcrun"
88 args = ["mcpbridge"]
89 ```
90
91 ## VS Code
92
93 ### With siGit Code Extension
94
95 Install from the [Visual Studio Code Marketplace](https://marketplace.visualstudio.com/items?itemName=getsigit.sigit-code).
96
97 ```jsonc
98 {
99 "sigit.agents": {
100 "sigit": {
101 "name": "siGit (on-device)",
102 "command": "sigit",
103 "args": [],
104 "env": {}
105 },
106 },
107 "sigit.agent.default": "sigit"
108 }
109 ```
110
111 ### With ACP Client
112
113 Install [ACP Client](https://marketplace.visualstudio.com/items?itemName=formulahendry.acp-client), then add:
114
115 ```json
116 {
117 "acp.agents": {
118 "siGit Code": {
119 "command": "sigit",
120 "args": [],
121 "env": {}
122 }
123 }
124 }
125 ```
126
127 ## Terminal mode
128
129 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.
130
131 Terminal mode currently needs Unix terminal behavior, so it works on macOS and Linux only.
132
133 ## Platform support
134
135 | Platform | Architecture |
136 |----------|-------------|
137 | macOS | arm64, x64 |
138 | Linux (glibc) | arm64, x64 |
139 | Windows | arm64, x64 |
140
141 ## License
142
143 [Apache 2.0](https://github.com/getsigit/sigit/blob/main/LICENSE)
144
145 ## Distribution
146
147 [Splitfire AB](https://5mb.app).
148
149 ## Copyright
150
151 © 2026 PT Sigit Mitra Bangun ([siGit Code & Deploy](https://sigit.si)).