Welcome to Bloodgrimoire - a powerful CLI tool for systematic BTC trading analysis and execution. This is not just a journal, but a complete trading system that helps you track, analyze, and improve your trading performance.
# Install globally from npm (coming soon)
npm install -g btc-bloodgrimoire
# For development or local usage, install from the repo
git clone https://github.com/username/btc-bloodgrimoire.git
cd btc-bloodgrimoire
npm install -g .
# Or use npx
npx btc-bloodgrimoire# Initialize your trading journal
bgrim init
# Log a new trade
bgrim trade new
# Analyze your performance
bgrim analyze
# Generate weekly report
bgrim analyze weekly
# View your stats dashboard
bgrim stats- Trade Tracking: Log and analyze your trades with detailed metadata including entry/exit prices, leverage, position size, and emotions
- Performance Analysis: Get insights into your trading patterns with weekly and monthly reports
- Strategy Management: Document and test your trading strategies with structured templates
- Market Analysis: Track market conditions and your trading bias over time
- Goal Setting: Define and monitor your trading objectives with progress tracking
- Atomic File Storage: All data is stored safely in markdown files using atomic write operations
- Cross-Platform: Works on macOS, Linux, and Windows
| Command | Description |
|---|---|
| Trade Management | |
bgrim trade new |
Create a new trade entry |
bgrim trade list |
List all trades |
bgrim trade show <id> |
Show details of a specific trade |
| Analysis | |
bgrim analyze weekly |
Weekly performance report |
bgrim analyze monthly |
Monthly performance report |
bgrim analyze all |
Complete performance analysis |
| Strategy | |
bgrim strategy new |
Create a new strategy |
bgrim strategy test |
Test a strategy |
bgrim strategy list |
List all strategies |
| Market | |
bgrim market bias |
Log market bias |
bgrim market signals |
Track trading signals |
bgrim price |
Show detailed live BTC price data |
| Goals | |
bgrim goals set |
Set new trading goals |
bgrim goals progress |
Check goal progress |
| Basic Commands | |
bgrim --help |
Show help information |
bgrim --version |
Show version number |
bgrim init |
Initialize your trading journal |
bgrim stats |
Show trading statistics dashboard |
Run this command to see your current trading stats:
bgrim statsExample output:
┌─────────────────────────────────────┐
│ PNL This Week: R1,245.50 │
│ Win Rate: 78% │
│ Avg Confidence: 7.4 │
│ Bad Trade Pattern: None detected │
│ Current Streak: 4 Wins │
│ BTC Price: $94245 │
└─────────────────────────────────────┘
This system runs on:
- Brutal honesty: Log wins and losses. Especially losses.
- System over gut: Emotion gets noted, but execution is mechanical.
- Review + Retaliate: Every week, review and build next week's focus.
- Schema-Based Learning: Use markdown + code to reflect, iterate, and improve decision-making systems.
- Cold Storage Wins: Profits are locked and loaded into BTC. Sovereignty is the endgame.
All trading data is stored locally in markdown files:
- Trades are stored by month (e.g.,
trades/2024-06-btc-daily.md) - Strategies are stored as individual files (e.g.,
strategies/rsi-volume-combo.md) - Market bias and signals are tracked monthly
- All files are plain markdown and can be edited with any text editor
Contributions are welcome! Please read our Contributing Guide for details on our code of conduct and the process for submitting pull requests.
This project is licensed under the MIT License - see the LICENSE file for details.
For support, please open an issue in the GitHub repository or contact us at support@bloodgrimoire.com.
-
/trades: Raw entries. Executions, logs, losses, wins. -
/strategies: Thought-out systems, plays, tools. -
/signals: Personal market bias, signals, indicators. -
/reflections: Lessons learned. Mistakes. Mental reps. -
/schemas: Structure for thoughts. Experiments. Code-powered feedback. -
/goals.md: Missions. Targets. Accountability. -
README.md: You are here.
bloodgrimoire/
├── bin/
│ └── bloodgrimoire.js # Main CLI entry point
├── trades/
│ ├── 2025-04-btc-daily.md
│ ├── 2025-04-margin-plays.md
├── strategies/
│ ├── rsi-volume-combo.md
│ ├── liquidity-snipe-system.md
├── signals/
│ ├── 2025-04-weekly-bias.md
├── reflections/
│ ├── trade-lessons-april.md
├── schemas/
│ ├── trade-schema.md
│ ├── feedback-loop.md
├── goals.md
└── README.md