A blockchain-powered trading companion for the emotional side of trading.
--- ## About Osias isn't a trading bot or a P&L tracker. Trades are already visible on-chain, so instead of asking you to log anything, Osias watches your connected Solana wallet in real time and steps in only when it detects loss-driven trading — a single bad trade or a losing streak past a threshold you control — by locking new buy actions on supported trading sites until the moment passes. This repository is the **open-source browser extension frontend** (Apache 2.0). The backend that makes the actual lock/unlock decisions — auth, wallet/RPC listening, realized-PnL tracking — is a separate, private service; this extension talks to it over a documented WebSocket protocol and never contains trading logic of its own. ## How it works 1. **Connect your wallet** — real Phantom sign-in via message signing. Your seed phrase and private key never touch the extension. 2. **Osias watches** — a live Solana subscription tracks your realized P&L in the background while you're connected, nothing more. 3. **Buying locks** — cross your configured threshold and new buy actions visually disable on the page. Sell and manage actions are never touched. 4. **The moment passes** — the lock auto-unlocks after a configurable cooldown, or you can unlock manually with an explicit confirmation. ## Features - Real Phantom wallet authentication — connect, sign, sign out, switch accounts - Real-time lockout enforcement on [axiom.trade](https://axiom.trade), with a non-destructive blur + lock-icon visual treatment - Two configurable circuit breakers (single-trade and losing-streak loss thresholds) plus a configurable auto-unlock cooldown, all tunable from the extension popup - Live backend connection status, so a dropped connection is never silently mistaken for "unlocked" - Built for Firefox/Zen and Chromium (Manifest V3) from one codebase See [`CLAUDE.md`](CLAUDE.md) for the full architecture — including the site-adapter / intervention-strategy split that new sites and lock treatments build on, and the complete WebSocket wire protocol shared with the backend. ## Getting started Scaffolded with [WXT](https://wxt.dev) (Vite-based, TypeScript, React, `webextension-polyfill`). Package manager: npm. ```sh npm install # also runs `wxt prepare` via postinstall npm run dev:firefox # dev build + watch, auto-opens a temporary Firefox/Zen profile ``` Other commands: | Command | What it does | | ----------------------- | ---------------------------------------------------------- | | `npm run dev` | Dev build + watch, targets Chromium by default | | `npm run dev:firefox` | Dev build + watch targeting Firefox (use this for Zen) | | `npm run build:firefox` | Production build → `.output/firefox-mv3/` | | `npm run zip:firefox` | Production build packaged as a `.zip` for store upload | | `npm run compile` | `tsc --noEmit` type-check only | To load an unpacked build: in Firefox/Zen, go to `about:debugging#/runtime/this-firefox` → "Load Temporary Add-on" → select any file inside `.output/firefox-mv3/`. ### Building from source for a store submission No build secrets, environment variables, or private dependencies are required — everything needed to build is in this repository and on the public npm registry, pinned via `package-lock.json`. - Node.js 22.x (built and tested on 22.11.0) - npm 11.x (built and tested on 11.14.1) ```sh npm install npm run build:firefox # → .output/firefox-mv3/ npm run zip:firefox # → .output/*.zip ``` ## Project structure ``` /src /background WebSocket connection to the backend, lock state, messaging /content-scripts /adapters Site-specific selectors + DOM strategy (axiom.trade first) /interventions Visual lock treatments (blur-disable, full-block stub) /popup Status, lock reason, Settings panel /notifications Toast/banner injected into the page /shared Typed message contracts, config ``` Decision-making (backend), site detection, and enforcement are deliberately decoupled — adding a new supported site or a new intervention type never requires touching the other two. Full detail in [`CLAUDE.md`](CLAUDE.md). ## Status Early public beta. Working end-to-end: real Phantom wallet sign-in, the `/ws` connection with reconnect handling, real-time lockout on axiom.trade, and per-user-configurable thresholds. See [`CLAUDE.md`](CLAUDE.md#current-status) for the full current-state summary. ## Contributing Issues and pull requests are welcome — this is a young project and honest feedback (bug reports especially) is genuinely useful right now. Please open an issue at [github.com/osias-trade/copilot/issues](https://github.com/osias-trade/copilot/issues). ## License [Apache License 2.0](LICENSE).