# tula

> A terminal tool that answers what no single venue can: what is my real exposure, and what breaks first? Non-custodial, and read-only for the moment — placing trades will come later.

You are long ETH spot on one exchange, short ETH perp on another, and holding ETH
as collateral against a debt on a lending protocol. Each venue is right about its
own piece and blind to the other two. tula reads all of them and answers the two
questions none of them can: **what is my real exposure**, and **what breaks
first**. Every figure is computed in plain code; a language model orchestrates
and narrates, and never does the arithmetic.

## What it reads

Hyperliquid (perps with liquidation price, spot, margin), Aave v3 on Ethereum
(collateral, debt and health factor), and an Ethereum wallet's ETH and ERC-20
balances — all three from a public address alone. Then Kraken, Binance, Coinbase
Advanced, Stripe and Circle Mint, each from a read-only key. A key that can
withdraw is refused rather than warned about.

## Commands

- `exposure` — net exposure per asset across every venue, with notional and the venues that contributed
- `breaks` — everything that can be liquidated, nearest first, with the move required to get there
- `shock <ASSET> <PCT>` — reprice the whole book and report what changes and what liquidates
- `venues` — per-venue counts, freshness and failures

A slash means a command; anything else is a question, answered in plain English
over the same vocabulary. Every command still works without a model key.

## Install

```sh
curl --proto '=https' --tlsv1.2 -LsSf https://hsnice16.github.io/tula/install.sh | sh
```

Also `brew install hsnice16/tap/tula` and `npm install -g @tula/cli` — the same
binary. macOS and Linux, 64-bit Intel and ARM; Windows through WSL. Every release
carries a published checksum, which the installer always checks and refuses on,
and a sigstore-backed build attestation, which it checks wherever the GitHub CLI
is installed and signed in to read one.

## Pages

- [Overview](https://hsnice16.github.io/tula/): What one asset held spot, short and pledged nets to, what breaks first, and the question you can ask in plain English instead.
- [Install](https://hsnice16.github.io/tula/install/): One command. Checksum and sigstore attestation, what it runs on, Homebrew and npm, and how to go back to a version.
- [Security](https://hsnice16.github.io/tula/security/): What tula promises about your credentials and your funds, what enforces each promise in the build, and where the edges are.
- [Sitemap](https://hsnice16.github.io/tula/sitemap.xml): every URL this site publishes

## Source

- [Repository](https://github.com/hsnice16/tula): MIT-licensed, open from the first commit — the only way anyone can check the claims above
- [Security policy](https://github.com/hsnice16/tula/blob/main/SECURITY.md): what is in scope and how to report privately
- [Changelog](https://github.com/hsnice16/tula/blob/main/CHANGELOG.md) and [roadmap](https://github.com/hsnice16/tula/blob/main/ROADMAP.md): read in the repository, where they are written