https://github.com/samitugal/bytepad
Your personal productivity companion
https://github.com/samitugal/bytepad
keyboard-first knowledge-graphs note-taking-app plain-text second-brain
Last synced: about 1 month ago
JSON representation
Your personal productivity companion
- Host: GitHub
- URL: https://github.com/samitugal/bytepad
- Owner: samitugal
- License: other
- Created: 2026-01-09T20:10:57.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2026-01-19T16:43:20.000Z (about 1 month ago)
- Last Synced: 2026-01-20T00:56:46.272Z (about 1 month ago)
- Topics: keyboard-first, knowledge-graphs, note-taking-app, plain-text, second-brain
- Language: TypeScript
- Homepage:
- Size: 7.89 MB
- Stars: 48
- Watchers: 1
- Forks: 3
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# bytepad
---
[](LICENSE)
[](#download)
[](https://github.com/samitugal/bytepad/releases)
bytepad is a keyboard-first, privacy-first productivity app built for people who think better in plain text.
It brings together notes, tasks, habits, and lightweight planning in a single, calm workspace—without forcing you into rigid systems or complex knowledge graphs. The goal isn’t to manage your life, but to reduce friction between thinking and doing.
Inspired by the clean, distraction-free aesthetics of code editors, bytepad favors:
* fast startup and instant interaction
* minimal UI, maximal focus
Your data stays local and under your control. No accounts, no tracking, no dark patterns. Sync and structure exist to support you, not to lock you in.
Bytepad is designed around a simple belief:
> Productivity tools should feel more like a text editor than a dashboard.
>
> Open it, type, think, close it.
---
## Why bytepad exists
bytepad exists because I think modern productivity tools often confuse structure with clarity.
Over time, notes turn into databases, simple tasks become workflows, and thinking gets replaced by organizing. I found myself spending more time maintaining the system than actually using it.
The principles behind bytepad are intentionally simple:
* Plain text over abstraction – if I can type it, I can use it
* Keyboard-first by default – thinking is faster than clicking
* Local-first, privacy-first – my data should stay mine
* Low cognitive load – the tool should disappear while I work
bytepad is built for people who enjoy the calm of a code editor, the flexibility of markdown, and the feeling of opening an app that never asks, “How would you like to organize this?”
---
## Generate your knowledge graph
bytepad doesn’t ask you to build a knowledge graph. It lets one emerge naturally.
Notes, tasks, habits, journal entries, and bookmarks are all treated as first-class entities. Anything can link to anything else using simple, readable connections.
Over time, these links form a personal knowledge graph that reflects how you actually think—not how a tool expects you to organize information.
---
## Features
### Core Modules
- **Notes** - Markdown editor with wikilinks (`[[Note]]`), backlinks, and tag organization
- **Daily Notes** - Quick daily entries with templates
- **Tasks** - Priority-based task management with subtasks and due dates
- **Habits** - Daily habit tracking with streaks and statistics
- **Journal** - Daily journaling with mood and energy tracking
- **Bookmarks** - Save and organize web links with tags
- **Calendar** - Visual calendar view for tasks and journal entries
- **Knowledge Graph** - Interactive visualization of connections between all your content
- **Analysis** - Weekly productivity statistics and AI-generated insights
### Additional Features
- **Focus Mode** - Pomodoro timer with customizable work/break intervals
- **Gamification** - XP, levels, and achievements to stay motivated
- **Localization** - English and Turkish language support
- **GitHub Gist Sync** - Optional cloud backup to private Gist
---
## FlowBot AI
Built-in AI assistant for productivity coaching and insights.
- Context-aware responses based on your data
- Natural language task and habit creation
- Personalized productivity tips and recommendations
- ADHD-friendly insights in productivity reports
### Supported AI Providers
| Provider | Models |
|----------|--------|
| OpenAI | GPT-4, GPT-3.5 |
| Anthropic | Claude 3 |
| Google AI | Gemini Pro |
| Groq | Llama, Mixtral |
| Ollama | Local models (self-hosted) |
---
---
## Download
Download the latest release from the [Releases](https://github.com/samitugal/bytepad/releases) page.
| Platform | File |
|----------|------|
| Windows | `bytepad-x.x.x-win-x64.exe` |
| macOS (Intel) | `bytepad-x.x.x-mac-x64.dmg` |
| macOS (Apple Silicon) | `bytepad-x.x.x-mac-arm64.dmg` |
| Linux | `bytepad-x.x.x-linux-x86_64.AppImage` |
### Installation Notes
**Windows**: If you see a SmartScreen warning, click "More info" then "Run anyway".
**macOS**: Right-click and select "Open" if prompted about unidentified developer.
**Linux**: Run `chmod +x bytepad-*.AppImage` before executing.
---
## Keyboard Shortcuts
bytepad is designed for keyboard-first navigation. Press `Ctrl+?` anytime to see all shortcuts.
| Shortcut | Action |
|----------|--------|
| `Ctrl+K` | Command Palette |
| `Alt+U` | Global Search |
| `Ctrl+/` | FlowBot AI Chat |
| `Ctrl+Shift+O` | Focus Mode |
| `Ctrl+N` | New Note |
| `Ctrl+1` to `Ctrl+9` | Switch Modules |
| `[[` | Wikilink Autocomplete |
---
## Privacy
- All data stored locally on your device
- No external servers (except optional Gist sync)
- AI features only send necessary context to your chosen provider
- API keys stored locally, never transmitted
---
## Contributing
See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup, code style, and contribution guidelines.
---
## License
**Personal Use License** - This software is licensed for personal, non-commercial use only.
See [LICENSE](LICENSE) for full details.
---
## Author
**Sami Tugal** - [@samitugal](https://github.com/samitugal)
---
*bytepad - Your personal productivity companion*