Crypto DeFi
A thorough crypto toolkit for tracking DeFi positions, managing portfolios, monitoring prices, watching whale activity, and analyzing market data. Crypto DeFi provides 16+ commands for recording and reviewing crypto-related observations with timestamped logs and multi-format data export.
Commands
| Command |
Description |
crypto-defi track <input> |
Record a tracking entry (token, protocol, position) — run without args to view recent entries |
crypto-defi portfolio <input> |
Log a portfolio update or snapshot — run without args to view recent portfolio entries |
crypto-defi alert <input> |
Record a price or event alert — run without args to view recent alerts |
crypto-defi price <input> |
Log a price observation — run without args to view recent price entries |
crypto-defi compare <input> |
Record a protocol or token comparison — run without args to view recent comparisons |
crypto-defi history <input> |
Log a historical note — run without args to view recent history entries |
crypto-defi gas <input> |
Record gas fee data — run without args to view recent gas entries |
crypto-defi whale-watch <input> |
Log whale activity observations — run without args to view recent whale-watch entries |
crypto-defi report <input> |
Record a report entry — run without args to view recent reports |
crypto-defi watchlist <input> |
Add to or view the watchlist — run without args to view recent watchlist entries |
crypto-defi analyze <input> |
Log an analysis note — run without args to view recent analysis entries |
crypto-defi export <input> |
Record an export event — run without args to view recent export entries |
crypto-defi stats |
Display summary statistics across all log categories |
crypto-defi search <term> |
Search across all log files for a keyword |
crypto-defi recent |
Show the 20 most recent activity entries from the history log |
crypto-defi status |
Health check — shows version, data directory, entry count, disk usage |
crypto-defi help |
Display available commands and usage information |
crypto-defi version |
Print current version (v2.0.0) |
Each data command (track, portfolio, alert, etc.) works in two modes:
- With arguments: Records the input with a timestamp into its dedicated log file
- Without arguments: Displays the 20 most recent entries from that category
Data Storage
All data is stored locally in plain-text log files:
- Location:
~/.local/share/crypto-defi/
- Format: Each entry is saved as
YYYY-MM-DD HH:MM|<value> in per-category .log files
- History: All operations are additionally logged to
history.log with timestamps
- Stats: The
stats command aggregates entry counts and disk usage across all categories
- No cloud sync — everything stays on your machine, no API keys needed
Requirements
- Bash 4.0+ (uses
set -euo pipefail)
- Standard Unix utilities:
date, wc, du, head, tail, grep, basename, cat
- No external dependencies, no API keys, no network access required
- Works on Linux and macOS
When to Use
- DeFi position tracking — Record yield farming positions, staking entries, and liquidity pool allocations with timestamps for historical review
- Portfolio management — Log portfolio snapshots, token balances, and allocation changes to maintain a running record of your holdings
- Whale activity monitoring — Use
whale-watch to record large transaction observations and spot market-moving activity patterns
- Gas fee tracking — Log gas fee observations over time to identify optimal transaction windows and track network congestion trends
- Multi-protocol comparison — Use
compare and analyze to record side-by-side protocol evaluations and store your analysis notes
Examples
# Track a new DeFi position
crypto-defi track "Uniswap V3 ETH/USDC 0.3% pool — 5 ETH deposited"
# Log current portfolio state
crypto-defi portfolio "BTC: 0.5, ETH: 10, SOL: 200 — total ~$45k"
# Record a price alert trigger
crypto-defi alert "ETH crossed $4000 resistance level"
# Log gas fee observation
crypto-defi gas "Ethereum mainnet base fee 25 gwei — good time for swaps"
# Record whale activity
crypto-defi whale-watch "0xdead... moved 10,000 ETH to Binance deposit address"
# View summary statistics across all categories
crypto-defi stats
# Search for all entries mentioning a specific protocol
crypto-defi search "Uniswap"
# Quick health check
crypto-defi status
Configuration
Set DATA_DIR by modifying the script or symlinking ~/.local/share/crypto-defi/ to your preferred location.
Powered by BytesAgain | bytesagain.com | hello@bytesagain.com
1---2name: defi-calculator3description: Calculate DeFi yields including APY, impermanent loss, and staking rewards. Use when estimating returns, comparing protocols, tracking farming.4---5# Crypto DeFi
6
7A thorough crypto toolkit for tracking DeFi positions, managing portfolios, monitoring prices, watching whale activity, and analyzing market data. Crypto DeFi provides 16+ commands for recording and reviewing crypto-related observations with timestamped logs and multi-format data export.
8
9## Commands
10
11| Command | Description |
12|---------|-------------|
13| `crypto-defi track <input>` | Record a tracking entry (token, protocol, position) — run without args to view recent entries |
14| `crypto-defi portfolio <input>` | Log a portfolio update or snapshot — run without args to view recent portfolio entries |
15| `crypto-defi alert <input>` | Record a price or event alert — run without args to view recent alerts |
16| `crypto-defi price <input>` | Log a price observation — run without args to view recent price entries |
17| `crypto-defi compare <input>` | Record a protocol or token comparison — run without args to view recent comparisons |
18| `crypto-defi history <input>` | Log a historical note — run without args to view recent history entries |
19| `crypto-defi gas <input>` | Record gas fee data — run without args to view recent gas entries |
20| `crypto-defi whale-watch <input>` | Log whale activity observations — run without args to view recent whale-watch entries |
21| `crypto-defi report <input>` | Record a report entry — run without args to view recent reports |
22| `crypto-defi watchlist <input>` | Add to or view the watchlist — run without args to view recent watchlist entries |
23| `crypto-defi analyze <input>` | Log an analysis note — run without args to view recent analysis entries |
24| `crypto-defi export <input>` | Record an export event — run without args to view recent export entries |
25| `crypto-defi stats` | Display summary statistics across all log categories |
26| `crypto-defi search <term>` | Search across all log files for a keyword |
27| `crypto-defi recent` | Show the 20 most recent activity entries from the history log |
28| `crypto-defi status` | Health check — shows version, data directory, entry count, disk usage |
29| `crypto-defi help` | Display available commands and usage information |
30| `crypto-defi version` | Print current version (v2.0.0) |
31
32Each data command (track, portfolio, alert, etc.) works in two modes:
33- **With arguments**: Records the input with a timestamp into its dedicated log file
34- **Without arguments**: Displays the 20 most recent entries from that category
35
36## Data Storage
37
38All data is stored locally in plain-text log files:
39
40- **Location**: `~/.local/share/crypto-defi/`
41- **Format**: Each entry is saved as `YYYY-MM-DD HH:MM|<value>` in per-category `.log` files
42- **History**: All operations are additionally logged to `history.log` with timestamps
43- **Stats**: The `stats` command aggregates entry counts and disk usage across all categories
44- **No cloud sync** — everything stays on your machine, no API keys needed
45
46## Requirements
47
48- Bash 4.0+ (uses `set -euo pipefail`)
49- Standard Unix utilities: `date`, `wc`, `du`, `head`, `tail`, `grep`, `basename`, `cat`
50- No external dependencies, no API keys, no network access required
51- Works on Linux and macOS
52
53## When to Use
54
551. **DeFi position tracking** — Record yield farming positions, staking entries, and liquidity pool allocations with timestamps for historical review
562. **Portfolio management** — Log portfolio snapshots, token balances, and allocation changes to maintain a running record of your holdings
573. **Whale activity monitoring** — Use `whale-watch` to record large transaction observations and spot market-moving activity patterns
584. **Gas fee tracking** — Log gas fee observations over time to identify optimal transaction windows and track network congestion trends
595. **Multi-protocol comparison** — Use `compare` and `analyze` to record side-by-side protocol evaluations and store your analysis notes
60
61## Examples
62
63```bash
64# Track a new DeFi position
65crypto-defi track "Uniswap V3 ETH/USDC 0.3% pool — 5 ETH deposited"
66
67# Log current portfolio state
68crypto-defi portfolio "BTC: 0.5, ETH: 10, SOL: 200 — total ~$45k"
69
70# Record a price alert trigger
71crypto-defi alert "ETH crossed $4000 resistance level"
72
73# Log gas fee observation
74crypto-defi gas "Ethereum mainnet base fee 25 gwei — good time for swaps"
75
76# Record whale activity
77crypto-defi whale-watch "0xdead... moved 10,000 ETH to Binance deposit address"
78
79# View summary statistics across all categories
80crypto-defi stats
81
82# Search for all entries mentioning a specific protocol
83crypto-defi search "Uniswap"
84
85# Quick health check
86crypto-defi status
87```
88
89## Configuration
90
91Set `DATA_DIR` by modifying the script or symlinking `~/.local/share/crypto-defi/` to your preferred location.
92
93---
94
95*Powered by BytesAgain | bytesagain.com | hello@bytesagain.com*
bytesagain