brainet


Namebrainet JSON
Version 0.2.0 PyPI version JSON
download
home_pagehttps://github.com/meetjoshi/brainet
SummaryAI-powered development context tracker - never lose your train of thought
upload_time2025-11-02 10:28:58
maintainerNone
docs_urlNone
authorMeet Joshi
requires_python>=3.8
licenseMIT
keywords ai development context git productivity claude groq llm developer-tools cli
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # ๐Ÿง  Brainet

**Never lose your train of thought again.**

Brainet is an AI-powered development context tracker that automatically captures what you're working on, why you're working on it, and what's next. Think of it as a second brain for your coding sessions.

<p align="center">
  <img src="https://img.shields.io/pypi/v/brainet" alt="PyPI">
  <img src="https://img.shields.io/pypi/pyversions/brainet" alt="Python">
  <img src="https://img.shields.io/badge/license-MIT-blue" alt="License">
</p>

---

## ๐Ÿš€ What's New in v0.2.0

**Major Architecture Overhaul - 5-Source Intelligence System:**

- **๐Ÿ” SOURCE 1 - Git Diffs**: Smart chunking with AST-based function extraction
- **๐Ÿ“„ SOURCE 2 - Full Files**: Complete code context for accurate answers
- **๐ŸŒฒ SOURCE 3 - AST Analysis**: Deep code structure understanding (classes, methods, imports)
- **๐ŸŽฏ SOURCE 4 - Semantic Search**: Proactive code discovery related to your queries
- **๐Ÿ“ฆ SOURCE 5 - Project Metadata**: Dependencies, file types, and project structure

**Critical Bugs Fixed:**
- โœ… First captures no longer show "removed" instead of "added" (fresh repo support)
- โœ… Ask command now provides specific, detailed answers with line numbers
- โœ… Proper diff counting (additions/deletions) in all scenarios

**New Features:**
- ๐ŸŽจ Capsule indexing (#01, #02, #03 format)
- ๐Ÿ‘๏ธ `brainet preview <index>` - View any historical capsule
- ๐Ÿ’ฌ Dramatically improved AI responses - specific method listings, accurate context
- ๐Ÿšซ No more internal mechanism exposure in answers

---

## ๐Ÿค” The Problem

You're deep in the zone, building a feature. Then...
- ๐Ÿ“ง An urgent email arrives
- ๐Ÿ”ฅ A production bug needs fixing  
- โ˜• You take a break
- ๐Ÿ“… It's Friday, you'll continue Monday

**Monday morning:** *"Wait... what was I doing? Why did I change this file? What was the plan?"*

You spend 30 minutes scrolling through git commits, reading code, trying to remember. Your flow state? Gone.

## โœจ The Solution

Brainet captures your coding sessions automatically and uses AI to create human-readable summaries:

```bash
$ brainet capture

๐Ÿ“ธ Context Captured
โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€
Added a Character class with methods for combat (attack, 
take_damage, heal), progression (gain_experience, level_up), 
and status checking (is_alive). Also added Inventory class 
with item management.

๐Ÿ“Š Stats:
   โ€ข 1 files modified
   โ€ข 67 lines added
   โ€ข 3 TODOs found

โœ“ Capsule saved: 2025-11-02 15:45:53
โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€
```

Now when you come back, just run `brainet history` and instantly remember everything.

---

## ๐Ÿš€ Quick Start

### Installation

```bash
# 1. Install brainet
pip install brainet --user

# 2. Add to PATH permanently
echo 'export PATH="$HOME/Library/Python/3.9/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
```

### Setup

```bash
# 1. Check it works
brainet --version

# 2. Get free API key from https://console.groq.com/keys

# 3. Set it permanently
echo 'export GROQ_API_KEY="gsk_your_key_here"' >> ~/.zshrc
source ~/.zshrc

# 4. Start using brainet in any git project!
cd your-project

brainet start
# ... make some changes ...
brainet capture --tag feature -m "Added user authentication"
```

That's it! Brainet is now tracking your development context.

---

## ๐Ÿ’ก Key Features

### ๐Ÿค– AI-Powered Summaries
Brainet uses Claude Sonnet 3.5 (via Groq) to understand your changes and generate intelligent summaries. It knows the difference between:
- Major features vs minor refactors
- Bug fixes vs new functionality  
- Breaking changes vs safe updates

### ๐Ÿ” Natural Language Querying (Powered by 5 Sources)
Ask questions about your work in plain English - now with comprehensive context:

```bash
$ brainet ask "what methods does the Character class have?"

You have a Character class with these methods: __init__ 
(lines 4-10), take_damage (lines 12-15), heal (lines 17-20), 
is_alive (lines 22-23), attack (lines 25-27), gain_experience 
(lines 29-32), and level_up (lines 34-39). The TODOs include 
adding a magic system with spells, implementing quest tracking, 
and adding save/load game functionality.
```

**v0.2.0 Intelligence:** Brainet now searches through full file contents, AST structure, and semantically related code to give you accurate, detailed answers with line numbers.

### ๐Ÿข Multi-Project Support
Working on multiple projects? Brainet handles it seamlessly:

```bash
$ brainet workspaces

๐Ÿ“š Active Brainet Sessions (3):
โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”ณโ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”ณโ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”“
โ”ƒ Project      โ”ƒ Location               โ”ƒ Capsules โ”ƒ
โ”กโ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ•‡โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ•‡โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”ฉ
โ”‚ api-backend  โ”‚ ~/projects/api         โ”‚       12 โ”‚
โ”‚ frontend-app โ”‚ ~/projects/frontend    โ”‚        8 โ”‚
โ”‚ mobile-app   โ”‚ ~/projects/mobile      โ”‚        5 โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
```

> **๐Ÿ“ Note:** The `workspaces` command scans these directories for brainet projects:
> - `~/Desktop` - For desktop projects
> - `~/Documents` - For document-based work
> - `~/Projects` - For dedicated project folders
> 
> Keep your projects in these locations for automatic discovery!

### ๐Ÿ”Ž Cross-Project Search
Find where you implemented that feature across all your projects:

```bash
$ brainet search "authentication" --all-projects

๐Ÿ” Found in 3 projects:
  โ€ข api-backend: JWT authentication with refresh tokens
  โ€ข frontend-app: Google OAuth integration
  โ€ข mobile-app: Biometric authentication added
```

### ๐Ÿ“Š Development Analytics
Understand your coding patterns:

```bash
$ brainet stats

๐Ÿ“Š Development Insights
โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€
  Sessions: 47
  Files modified: 234
  Most active file: auth.py (23 changes)
  Top tags: feature, bugfix, refactor
  
  Recent activity:
  โ€ข 15 sessions this week
  โ€ข Peak productivity: Tuesday afternoons
โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€
```

---

## ๐Ÿ“š Commands

| Command | Description |
|---------|-------------|
| `brainet start` | Initialize tracking in current project |
| `brainet capture` | Save current session with AI summary |
| `brainet history` | View all captured sessions with #01, #02 indexing |
| `brainet preview` | Preview what will be captured next |
| `brainet preview <N>` | View historical capsule #N |
| `brainet ask "question"` | Query your work with AI (v0.2.0: 5-source intelligence) |
| `brainet search "keyword"` | Search across sessions |
| `brainet workspaces` | List all tracked projects |
| `brainet stats` | View development analytics |
| `brainet export` | Export sessions to Markdown |
| `brainet diff <file>` | View colorized file changes |
| `brainet switch` | Quick navigation between projects |

Run `brainet --help` for full command list.

---

## ๐ŸŽฏ Real-World Use Cases

### 1. **Context Switching**
Switch between tasks without losing context:
```bash
# Working on Feature A
brainet capture --tag feature-a

# Emergency bug fix needed
brainet pause
cd ~/other-project
brainet start
# Fix bug...
brainet capture --tag hotfix

# Back to Feature A
cd ~/original-project
brainet resume  # Instantly recall where you left off
```

### 2. **Code Reviews**
Generate PR descriptions automatically:
```bash
brainet export --since yesterday

# Copy the AI-generated summary into your PR
```

### 3. **Weekly Standups**
"What did I work on this week?"
```bash
brainet history --since "1 week ago"

# See all your accomplishments summarized
```

### 4. **Knowledge Transfer**
Onboarding a teammate:
```bash
brainet export --tag authentication > auth_work.md

# Share the complete history of authentication feature
```

---

## ๐Ÿ› ๏ธ How It Works

1. **File Watching** - Tracks changes in your git repository
2. **Git Integration** - Captures commits, diffs, and file changes
3. **TODO Extraction** - Finds TODO comments automatically
4. **AI Analysis** - Claude Sonnet 3.5 generates intelligent summaries
5. **Local Storage** - Everything saved locally in `.brainet/` folder

**Privacy First:** All your data stays on your machine. AI summaries are generated via API but your code never leaves your control.

---

## ๐Ÿ”ง Configuration

### API Keys

Brainet supports two AI providers:

**Groq (Recommended)** - Free, fast, 500+ tokens/sec
```bash
export GROQ_API_KEY="your_key_here"
```

**Anthropic Claude** - More powerful, requires paid account
```bash
export ANTHROPIC_API_KEY="your_key_here"
```

### Advanced Options

```bash
# Capture with custom tags
brainet capture --tag feature --tag auth -m "Added JWT support"

# Export filtered sessions
brainet export --tag bugfix --since "2024-10-01"

# Search in current project only
brainet search "payment integration"

# Clean up old sessions
brainet cleanup --days 90
```

---

## ๐ŸŽ“ Best Practices

1. **Capture Often** - At least once per coding session
2. **Use Tags** - Organize with `--tag feature`, `--tag bugfix`, etc.
3. **Add Messages** - Use `-m` for important context
4. **Regular Cleanup** - Run `brainet cleanup` monthly
5. **Export Important Work** - Save milestones to Markdown
6. **Organize Projects** - Keep projects in `~/Desktop`, `~/Documents`, or `~/Projects` for the `workspaces` command to find them automatically

---

## ๐Ÿค Contributing

Brainet is open source! Contributions welcome:

1. Fork the repository
2. Create your feature branch (`git checkout -b feature/amazing`)
3. Commit your changes (`git commit -m 'Add amazing feature'`)
4. Push to the branch (`git push origin feature/amazing`)
5. Open a Pull Request

---

## ๐Ÿ“„ License

MIT License - see [LICENSE](LICENSE) file for details.

---

## ๐Ÿ™ Acknowledgments

- Built with [Anthropic Claude](https://anthropic.com)
- Powered by [Groq](https://groq.com) for fast AI inference
- Uses [Rich](https://github.com/Textualize/rich) for beautiful terminal output
- Created for developers, by developers

---

## ๐Ÿ’ฌ Support

- **Issues:** [GitHub Issues](https://github.com/meetjoshi/brainet/issues)
- **Discussions:** [GitHub Discussions](https://github.com/meetjoshi/brainet/discussions)
- **Email:** meet@brainet.dev

---

<p align="center">
  <strong>Stop losing context. Start using Brainet.</strong>
  <br><br>
  Made with โค๏ธ for developers who value flow state
</p>



            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/meetjoshi/brainet",
    "name": "brainet",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.8",
    "maintainer_email": null,
    "keywords": "ai development context git productivity claude groq llm developer-tools cli",
    "author": "Meet Joshi",
    "author_email": "meet@brainet.dev",
    "download_url": "https://files.pythonhosted.org/packages/20/f9/044785f7c5966f343a1ae2f8ddb768ef4a6a7ae955d544ea215d76281cc8/brainet-0.2.0.tar.gz",
    "platform": null,
    "description": "# \ud83e\udde0 Brainet\n\n**Never lose your train of thought again.**\n\nBrainet is an AI-powered development context tracker that automatically captures what you're working on, why you're working on it, and what's next. Think of it as a second brain for your coding sessions.\n\n<p align=\"center\">\n  <img src=\"https://img.shields.io/pypi/v/brainet\" alt=\"PyPI\">\n  <img src=\"https://img.shields.io/pypi/pyversions/brainet\" alt=\"Python\">\n  <img src=\"https://img.shields.io/badge/license-MIT-blue\" alt=\"License\">\n</p>\n\n---\n\n## \ud83d\ude80 What's New in v0.2.0\n\n**Major Architecture Overhaul - 5-Source Intelligence System:**\n\n- **\ud83d\udd0d SOURCE 1 - Git Diffs**: Smart chunking with AST-based function extraction\n- **\ud83d\udcc4 SOURCE 2 - Full Files**: Complete code context for accurate answers\n- **\ud83c\udf32 SOURCE 3 - AST Analysis**: Deep code structure understanding (classes, methods, imports)\n- **\ud83c\udfaf SOURCE 4 - Semantic Search**: Proactive code discovery related to your queries\n- **\ud83d\udce6 SOURCE 5 - Project Metadata**: Dependencies, file types, and project structure\n\n**Critical Bugs Fixed:**\n- \u2705 First captures no longer show \"removed\" instead of \"added\" (fresh repo support)\n- \u2705 Ask command now provides specific, detailed answers with line numbers\n- \u2705 Proper diff counting (additions/deletions) in all scenarios\n\n**New Features:**\n- \ud83c\udfa8 Capsule indexing (#01, #02, #03 format)\n- \ud83d\udc41\ufe0f `brainet preview <index>` - View any historical capsule\n- \ud83d\udcac Dramatically improved AI responses - specific method listings, accurate context\n- \ud83d\udeab No more internal mechanism exposure in answers\n\n---\n\n## \ud83e\udd14 The Problem\n\nYou're deep in the zone, building a feature. Then...\n- \ud83d\udce7 An urgent email arrives\n- \ud83d\udd25 A production bug needs fixing  \n- \u2615 You take a break\n- \ud83d\udcc5 It's Friday, you'll continue Monday\n\n**Monday morning:** *\"Wait... what was I doing? Why did I change this file? What was the plan?\"*\n\nYou spend 30 minutes scrolling through git commits, reading code, trying to remember. Your flow state? Gone.\n\n## \u2728 The Solution\n\nBrainet captures your coding sessions automatically and uses AI to create human-readable summaries:\n\n```bash\n$ brainet capture\n\n\ud83d\udcf8 Context Captured\n\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\nAdded a Character class with methods for combat (attack, \ntake_damage, heal), progression (gain_experience, level_up), \nand status checking (is_alive). Also added Inventory class \nwith item management.\n\n\ud83d\udcca Stats:\n   \u2022 1 files modified\n   \u2022 67 lines added\n   \u2022 3 TODOs found\n\n\u2713 Capsule saved: 2025-11-02 15:45:53\n\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n```\n\nNow when you come back, just run `brainet history` and instantly remember everything.\n\n---\n\n## \ud83d\ude80 Quick Start\n\n### Installation\n\n```bash\n# 1. Install brainet\npip install brainet --user\n\n# 2. Add to PATH permanently\necho 'export PATH=\"$HOME/Library/Python/3.9/bin:$PATH\"' >> ~/.zshrc\nsource ~/.zshrc\n```\n\n### Setup\n\n```bash\n# 1. Check it works\nbrainet --version\n\n# 2. Get free API key from https://console.groq.com/keys\n\n# 3. Set it permanently\necho 'export GROQ_API_KEY=\"gsk_your_key_here\"' >> ~/.zshrc\nsource ~/.zshrc\n\n# 4. Start using brainet in any git project!\ncd your-project\n\nbrainet start\n# ... make some changes ...\nbrainet capture --tag feature -m \"Added user authentication\"\n```\n\nThat's it! Brainet is now tracking your development context.\n\n---\n\n## \ud83d\udca1 Key Features\n\n### \ud83e\udd16 AI-Powered Summaries\nBrainet uses Claude Sonnet 3.5 (via Groq) to understand your changes and generate intelligent summaries. It knows the difference between:\n- Major features vs minor refactors\n- Bug fixes vs new functionality  \n- Breaking changes vs safe updates\n\n### \ud83d\udd0d Natural Language Querying (Powered by 5 Sources)\nAsk questions about your work in plain English - now with comprehensive context:\n\n```bash\n$ brainet ask \"what methods does the Character class have?\"\n\nYou have a Character class with these methods: __init__ \n(lines 4-10), take_damage (lines 12-15), heal (lines 17-20), \nis_alive (lines 22-23), attack (lines 25-27), gain_experience \n(lines 29-32), and level_up (lines 34-39). The TODOs include \nadding a magic system with spells, implementing quest tracking, \nand adding save/load game functionality.\n```\n\n**v0.2.0 Intelligence:** Brainet now searches through full file contents, AST structure, and semantically related code to give you accurate, detailed answers with line numbers.\n\n### \ud83c\udfe2 Multi-Project Support\nWorking on multiple projects? Brainet handles it seamlessly:\n\n```bash\n$ brainet workspaces\n\n\ud83d\udcda Active Brainet Sessions (3):\n\u250f\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2533\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2533\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2513\n\u2503 Project      \u2503 Location               \u2503 Capsules \u2503\n\u2521\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2547\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2547\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2529\n\u2502 api-backend  \u2502 ~/projects/api         \u2502       12 \u2502\n\u2502 frontend-app \u2502 ~/projects/frontend    \u2502        8 \u2502\n\u2502 mobile-app   \u2502 ~/projects/mobile      \u2502        5 \u2502\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n```\n\n> **\ud83d\udccd Note:** The `workspaces` command scans these directories for brainet projects:\n> - `~/Desktop` - For desktop projects\n> - `~/Documents` - For document-based work\n> - `~/Projects` - For dedicated project folders\n> \n> Keep your projects in these locations for automatic discovery!\n\n### \ud83d\udd0e Cross-Project Search\nFind where you implemented that feature across all your projects:\n\n```bash\n$ brainet search \"authentication\" --all-projects\n\n\ud83d\udd0d Found in 3 projects:\n  \u2022 api-backend: JWT authentication with refresh tokens\n  \u2022 frontend-app: Google OAuth integration\n  \u2022 mobile-app: Biometric authentication added\n```\n\n### \ud83d\udcca Development Analytics\nUnderstand your coding patterns:\n\n```bash\n$ brainet stats\n\n\ud83d\udcca Development Insights\n\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n  Sessions: 47\n  Files modified: 234\n  Most active file: auth.py (23 changes)\n  Top tags: feature, bugfix, refactor\n  \n  Recent activity:\n  \u2022 15 sessions this week\n  \u2022 Peak productivity: Tuesday afternoons\n\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n```\n\n---\n\n## \ud83d\udcda Commands\n\n| Command | Description |\n|---------|-------------|\n| `brainet start` | Initialize tracking in current project |\n| `brainet capture` | Save current session with AI summary |\n| `brainet history` | View all captured sessions with #01, #02 indexing |\n| `brainet preview` | Preview what will be captured next |\n| `brainet preview <N>` | View historical capsule #N |\n| `brainet ask \"question\"` | Query your work with AI (v0.2.0: 5-source intelligence) |\n| `brainet search \"keyword\"` | Search across sessions |\n| `brainet workspaces` | List all tracked projects |\n| `brainet stats` | View development analytics |\n| `brainet export` | Export sessions to Markdown |\n| `brainet diff <file>` | View colorized file changes |\n| `brainet switch` | Quick navigation between projects |\n\nRun `brainet --help` for full command list.\n\n---\n\n## \ud83c\udfaf Real-World Use Cases\n\n### 1. **Context Switching**\nSwitch between tasks without losing context:\n```bash\n# Working on Feature A\nbrainet capture --tag feature-a\n\n# Emergency bug fix needed\nbrainet pause\ncd ~/other-project\nbrainet start\n# Fix bug...\nbrainet capture --tag hotfix\n\n# Back to Feature A\ncd ~/original-project\nbrainet resume  # Instantly recall where you left off\n```\n\n### 2. **Code Reviews**\nGenerate PR descriptions automatically:\n```bash\nbrainet export --since yesterday\n\n# Copy the AI-generated summary into your PR\n```\n\n### 3. **Weekly Standups**\n\"What did I work on this week?\"\n```bash\nbrainet history --since \"1 week ago\"\n\n# See all your accomplishments summarized\n```\n\n### 4. **Knowledge Transfer**\nOnboarding a teammate:\n```bash\nbrainet export --tag authentication > auth_work.md\n\n# Share the complete history of authentication feature\n```\n\n---\n\n## \ud83d\udee0\ufe0f How It Works\n\n1. **File Watching** - Tracks changes in your git repository\n2. **Git Integration** - Captures commits, diffs, and file changes\n3. **TODO Extraction** - Finds TODO comments automatically\n4. **AI Analysis** - Claude Sonnet 3.5 generates intelligent summaries\n5. **Local Storage** - Everything saved locally in `.brainet/` folder\n\n**Privacy First:** All your data stays on your machine. AI summaries are generated via API but your code never leaves your control.\n\n---\n\n## \ud83d\udd27 Configuration\n\n### API Keys\n\nBrainet supports two AI providers:\n\n**Groq (Recommended)** - Free, fast, 500+ tokens/sec\n```bash\nexport GROQ_API_KEY=\"your_key_here\"\n```\n\n**Anthropic Claude** - More powerful, requires paid account\n```bash\nexport ANTHROPIC_API_KEY=\"your_key_here\"\n```\n\n### Advanced Options\n\n```bash\n# Capture with custom tags\nbrainet capture --tag feature --tag auth -m \"Added JWT support\"\n\n# Export filtered sessions\nbrainet export --tag bugfix --since \"2024-10-01\"\n\n# Search in current project only\nbrainet search \"payment integration\"\n\n# Clean up old sessions\nbrainet cleanup --days 90\n```\n\n---\n\n## \ud83c\udf93 Best Practices\n\n1. **Capture Often** - At least once per coding session\n2. **Use Tags** - Organize with `--tag feature`, `--tag bugfix`, etc.\n3. **Add Messages** - Use `-m` for important context\n4. **Regular Cleanup** - Run `brainet cleanup` monthly\n5. **Export Important Work** - Save milestones to Markdown\n6. **Organize Projects** - Keep projects in `~/Desktop`, `~/Documents`, or `~/Projects` for the `workspaces` command to find them automatically\n\n---\n\n## \ud83e\udd1d Contributing\n\nBrainet is open source! Contributions welcome:\n\n1. Fork the repository\n2. Create your feature branch (`git checkout -b feature/amazing`)\n3. Commit your changes (`git commit -m 'Add amazing feature'`)\n4. Push to the branch (`git push origin feature/amazing`)\n5. Open a Pull Request\n\n---\n\n## \ud83d\udcc4 License\n\nMIT License - see [LICENSE](LICENSE) file for details.\n\n---\n\n## \ud83d\ude4f Acknowledgments\n\n- Built with [Anthropic Claude](https://anthropic.com)\n- Powered by [Groq](https://groq.com) for fast AI inference\n- Uses [Rich](https://github.com/Textualize/rich) for beautiful terminal output\n- Created for developers, by developers\n\n---\n\n## \ud83d\udcac Support\n\n- **Issues:** [GitHub Issues](https://github.com/meetjoshi/brainet/issues)\n- **Discussions:** [GitHub Discussions](https://github.com/meetjoshi/brainet/discussions)\n- **Email:** meet@brainet.dev\n\n---\n\n<p align=\"center\">\n  <strong>Stop losing context. Start using Brainet.</strong>\n  <br><br>\n  Made with \u2764\ufe0f for developers who value flow state\n</p>\n\n\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "AI-powered development context tracker - never lose your train of thought",
    "version": "0.2.0",
    "project_urls": {
        "Bug Reports": "https://github.com/meetjoshi/brainet/issues",
        "Documentation": "https://github.com/meetjoshi/brainet#readme",
        "Homepage": "https://github.com/meetjoshi/brainet",
        "Source": "https://github.com/meetjoshi/brainet"
    },
    "split_keywords": [
        "ai",
        "development",
        "context",
        "git",
        "productivity",
        "claude",
        "groq",
        "llm",
        "developer-tools",
        "cli"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "5357c0f7c7a5d5ae3ca41c839a9a235a771696f2b0ab1e5f0cedcc65a12ca905",
                "md5": "9613194b15a035219ace47349537f9bd",
                "sha256": "bbfbe639ae37f71233812ca0859273dbf7a9bf9c8816058dfc8b20d4a4a784eb"
            },
            "downloads": -1,
            "filename": "brainet-0.2.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "9613194b15a035219ace47349537f9bd",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.8",
            "size": 84916,
            "upload_time": "2025-11-02T10:28:57",
            "upload_time_iso_8601": "2025-11-02T10:28:57.199368Z",
            "url": "https://files.pythonhosted.org/packages/53/57/c0f7c7a5d5ae3ca41c839a9a235a771696f2b0ab1e5f0cedcc65a12ca905/brainet-0.2.0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "20f9044785f7c5966f343a1ae2f8ddb768ef4a6a7ae955d544ea215d76281cc8",
                "md5": "2cde23bf3601ce573fab70415c9a40f2",
                "sha256": "86ef50935812f152e54814f2dd54f29a5c1ff95b824ef603ba9a6cc000e0e490"
            },
            "downloads": -1,
            "filename": "brainet-0.2.0.tar.gz",
            "has_sig": false,
            "md5_digest": "2cde23bf3601ce573fab70415c9a40f2",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.8",
            "size": 87618,
            "upload_time": "2025-11-02T10:28:58",
            "upload_time_iso_8601": "2025-11-02T10:28:58.938496Z",
            "url": "https://files.pythonhosted.org/packages/20/f9/044785f7c5966f343a1ae2f8ddb768ef4a6a7ae955d544ea215d76281cc8/brainet-0.2.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-11-02 10:28:58",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "meetjoshi",
    "github_project": "brainet",
    "github_not_found": true,
    "lcname": "brainet"
}
        
Elapsed time: 2.02826s