aegis-spreadwatch README

The project's README from github.com/Lavagroabide/aegis-spreadwatch. As one markdown file: README.md.

Aegis SpreadWatch

Tauri v2 Rust React License: MIT

Aegis SpreadWatch hero

Aegis SpreadWatch is a native, local-first CS2 trading workspace for people who want the numbers to stay legible. It separates market opportunities, account access, buy plans and fee assumptions into calm, purpose-built workspaces instead of one overloaded dashboard.

The UI ships with a deterministic 15-item market fixture so the terminal is useful immediately in development. Venue requests are isolated behind Rust commands and can be connected to authenticated adapters without changing the React surface.

Download

One zip, attached to the latest release. It carries Main.exe, its update settings and the Aegis SpreadWatch runtime, so nothing else has to be installed:

System File
Windows 10 and 11 aegis-spreadwatch.zip

Unpack the whole folder and start Main.exe. No installer, no admin rights.

Main.exe is code-signed, so Windows starts it without a warning. Keep Aegis SpreadWatch next to it: they ship together.

Product surface

Workspace Purpose Primary action
Spread scanner Compare executable buy/sell opportunities Inspect the net-return calculation
Account vaults Review inventory, access and local Steam Guard codes Import a vault for the current session
Buy orders Keep acquisition limits and bid position visible Create a local order plan
Connections & fees Set the assumptions behind every estimate Save a fee model or endpoint profile

Market model

Aegis treats every venue as a separate fee and settlement model. The scanner reports the amount that remains after the sell-side fee, not a headline spread.

Venue Default fee Settlement Role
Steam Community Market 13.00% USD High-liquidity exit reference
Buff163 2.50% CNY → USD Low-fee acquisition venue
CSFloat 2.00% USD Float-aware listings
Skinport 12.00% EUR → USD Consumer-facing exit venue
Waxpeer 6.00% USD Secondary liquidity route

Architecture

flowchart LR
  UI[React + TypeScript\nDense terminal UI] -->|invoke| CMD[Tauri v2 commands]
  CMD --> ENGINE[Net return engine\nfees + FX + hold state]
  CMD --> TOTP[Steam Guard TOTP\nHMAC-SHA1 in Rust]
  CMD --> VENUES[Venue adapters\nreqwest + rustls]
  CMD --> STORE[(app_data_dir\naegis-spreadwatch-state.json)]
  VENUES --> QUOTES[Market quotes]
  QUOTES --> UI

Local development

Requirements

Run the web surface

npm install
npm run dev

Starts the Vite frontend dev server with hot-reload at http://localhost:1420.

Run the native app

npm run tauri dev

Create a Windows installer

npm run tauri build

Tauri writes the Windows artifacts under src-tauri/target/release/bundle/. The included GitHub Actions workflow builds and attaches the installer when a v*.*.* tag is pushed.

Rust commands

The backend exposes small, testable commands:

Screenshots

Scanner Vaults
Scanner Vaults
Buy orders Endpoints
Orders Endpoints

Repository layout

aegis-spreadwatch/
├── src/
│   ├── App.tsx                 Desktop shell, spread scanner and Inspector
│   ├── Workspaces.tsx           Account vaults, buy plans and connection settings
│   ├── model.ts                 UI model, fee math and CSV export
│   └── styles.css               Product tokens and workspace layout
├── src-tauri/
│   ├── src/
│   │   ├── lib.rs               Tauri command entrypoint and public quote polling
│   │   ├── spread.rs            Engine Core: fee-adjusted spread calculations
│   │   ├── totp.rs              TOTP Vault: Steam Guard HMAC-SHA1 generation
│   │   └── state.rs             Local state: app-data JSON persistence
│   └── Cargo.toml               Native engine dependencies and bundle settings
├── docs/assets/
│   ├── logo.svg                 Aegis brand mark
│   ├── hero-banner.png          Project header banner
│   ├── demo-preview.gif         Workspace walkthrough
│   └── screenshots/             Scanner, vault, order and settings captures
├── .github/workflows/
│   └── release.yml              Windows installer release pipeline
├── package.json                 Frontend scripts and runtime dependencies
└── README.md                    Product, architecture and build documentation

License

MIT. See LICENSE.

aegis-spreadwatch (Lavagroabide/aegis-spreadwatch)

Searching Database…

Aegis SpreadWatch is a native, local-first CS2 trading workspace for people who want the numbers to stay legible. It separates market opportunities, account access, buy plans and fee assumptions into calm, purpose-built workspaces instead of one overloaded dashboard.

Size
1.3 MB
Stars
125
Age
1d
Commits · 90 Days