cclohmar/inboxer
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
inBOXER - Email classification and organization tool using IMAP and AI
2 commits 1 branch 3 tags 32 MiB
Go 78.2%
HTML 9.3%
Shell 6.8%
CSS 4.5%
Makefile 1.2%
Find a file
cclohmar 8bb9ff067b Phase 2: IMAP Client & Background Worker (Version: 2026-04.2) 
- IMAP client package with TLS/STARTTLS connection management, unseen fetching, batch fetching by UID range, message move/copy operations, folder management
- Background worker with steady-state (unseen polling) and catch-up (UID range backlog) modes, per-user IMAP connections, test mode support, placeholder AI classifier
- Database: GetUsersWithAutoStart() for worker user discovery
- Wired worker into main.go with graceful shutdown
2026-04-23 11:02:02 +00:00
bin Phase 1: Foundation, OTP Auth & Mobile Frontend (Version: 2026-04.1) 2026-04-23 08:26:32 +00:00
docs Phase 2: IMAP Client & Background Worker (Version: 2026-04.2) 2026-04-23 11:02:02 +00:00
src Phase 2: IMAP Client & Background Worker (Version: 2026-04.2) 2026-04-23 11:02:02 +00:00
.gitignore Phase 1: Foundation, OTP Auth & Mobile Frontend (Version: 2026-04.1) 2026-04-23 08:26:32 +00:00
AGENTS.md Phase 1: Foundation, OTP Auth & Mobile Frontend (Version: 2026-04.1) 2026-04-23 08:26:32 +00:00
go.mod Phase 2: IMAP Client & Background Worker (Version: 2026-04.2) 2026-04-23 11:02:02 +00:00
go.sum Phase 2: IMAP Client & Background Worker (Version: 2026-04.2) 2026-04-23 11:02:02 +00:00
Makefile Phase 1: Foundation, OTP Auth & Mobile Frontend (Version: 2026-04.1) 2026-04-23 08:26:32 +00:00
PROJECT_PLAN.md Phase 1: Foundation, OTP Auth & Mobile Frontend (Version: 2026-04.1) 2026-04-23 08:26:32 +00:00
README.md Phase 1: Foundation, OTP Auth & Mobile Frontend (Version: 2026-04.1) 2026-04-23 08:26:32 +00:00

README.md

inBOXER

Email classification and organization tool using IMAP and AI.

Overview

inBOXER is a Go application that:

  • Connects to your IMAP email account
  • Uses DeepSeek AI to classify incoming emails
  • Automatically moves emails to appropriate folders (Important, eCommerce, Other, Spam)
  • Provides a web interface for configuration and monitoring

Features

  • Email + OTP Authentication: Secure login without passwords
  • AI-Powered Classification: Uses DeepSeek LLM for intelligent email sorting
  • Mobile-First Web Interface: Responsive design for all devices
  • Modular Architecture: Clean separation of concerns (auth, IMAP, AI, database, worker)
  • Test Mode: Preview AI decisions without moving emails

Quick Start

  1. Clone the repository
  2. Configure .env with your API keys and credentials
  3. Run make build to compile the binary
  4. Run make run to start the application
  5. Access the web interface at http://localhost:8080

Architecture

See PROJECT_PLAN.md for detailed architecture and development phases.

License

See docs/LICENSE.md for license information.