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 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.
14
15 You can use it in two ways:
16
17 - **ACP mode:** Zed or another ACP-compatible editor starts it over stdio
18 - **Terminal mode:** run `sigit` for the interactive chat UI
19
20 | Platform | ACP mode | Terminal mode |
21 |----------|----------|---------------|
22 | macOS | ✓ | ✓ |
23 | Linux | ✓ | ✓ |
24 | Windows | ✓ | not yet |
25
26 ## smbCloud context
27
28 In an smbCloud repo, siGit Code already knows a few important things:
29
30 - platform-user flows and tenant-app auth flows are different systems
31 - `Project` is the umbrella workspace, while `FrontendApp`, `AuthApp`, and GresIQ are separate deployable units
32 - Next.js SSR deploys are not the same thing as the generic git-push path
33 - existing crate boundaries and workspace patterns are usually the right place to start
34
35 In other repos it stays general and does not pretend everything is about smbCloud.
36
37 ## Install
38
39 ```sh
40 cargo install sigit
41 ```
42
43 | Method | Command |
44 |--------|---------|
45 | Homebrew | `brew tap getsigit/tap && brew install sigit` |
46 | pip | `pip install sigit-code` |
47 | uv | `uvx --from sigit-code sigit` |
48 | npm | `npm install -g @smbcloud/sigit` |
49
50 ## First run
51
52 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.
53
54 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.
55
56 ## Zed setup
57
58 Add this to `~/.config/zed/settings.json`:
59
60 ```json
61 {
62 "agent_servers": {
63 "siGit Code": {
64 "type": "custom",
65 "command": "/absolute/path/to/sigit"
66 }
67 }
68 }
69 ```
70
71 Use the full absolute path. `~` does not expand here.
72
73 ## VS Code with ACP Client
74
75 Install [ACP Client](https://marketplace.visualstudio.com/items?itemName=formulahendry.acp-client), then add:
76
77 ```json
78 {
79 "acp.agents": {
80 "siGit Code": {
81 "command": "sigit",
82 "args": [],
83 "env": {}
84 }
85 }
86 }
87 ```
88
89 ## Terminal mode
90
91 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.
92
93 Terminal mode currently needs Unix terminal behavior, so it works on macOS and Linux only.
94
95 ## Platform support
96
97 | Platform | Architecture |
98 |----------|-------------|
99 | macOS | arm64, x64 |
100 | Linux (glibc) | arm64, x64 |
101 | Windows | arm64, x64 |
102
103 ## License
104
105 [Apache 2.0](https://github.com/getsigit/sigit/blob/main/LICENSE)
106
107 ## Copyright
108
109 © 2026 [smbCloud](https://smbcloud.xyz/) (Splitfire AB).