A secure terminal-based journaling system designed as a safe space for developers going through heartbreak, breakups, or betrayal
A secure, private terminal-based journaling application designed specifically for developers going through heartbreak, breakups, or betrayal. EmotionCtl provides a safe digital sanctuary to process emotions, track healing progress, and maintain mental health during life's most challenging moments.
As developers, we're often so focused on solving technical problems that we neglect our emotional well-being. When relationships end or trust is broken, we need a private space to process these complex feelings without judgment. EmotionCtl combines the security you expect as a developer with the emotional support you need as a human.
🔐 Complete Privacy: Military-grade AES-256-CBC encryption keeps your deepest thoughts secure
💙 Safe Space: Judgment-free zone designed for emotional processing and healing
📝 Expressive Journaling: Write freely with mood tracking, tags, and rich text support
🔍 Pattern Recognition: Search and analyze your emotional journey to understand triggers and growth
💾 Secure Backups: Encrypted backups ensure your healing journey is never lost
🎨 Gentle Interface: Calming terminal UI that respects your emotional state
📊 Progress Tracking: Visualize your healing journey with detailed statistics
🛡️ Developer-Grade Security: PBKDF2 password hashing and local-only storage
You can run EmotionCtl instantly without installation using npx:
# Initialize your safe space
npx emotionctl init
# Start writing
npx emotionctl write
# Read your entries
npx emotionctl read
This downloads and runs the latest version each time, ensuring you always have the most up-to-date healing tools.
For frequent use, you can install EmotionCtl globally on your system:
# Install directly from npm
npm install -g emotionctl
Or with yarn:
# Install with yarn
yarn global add emotionctl
Once installed globally, you can use emotionctl from anywhere on your system:
# Initialize your safe space
emotionctl init
# Start writing
emotionctl write
# Read your entries
emotionctl read --list
# Get help
emotionctl --help
For development or contributing to the project:
yarn install
yarn build
node dist/index.js --help
Create your private, encrypted emotional sanctuary:
emotionctl init
This creates a secure space where you can process your feelings without fear of judgment or exposure.
Express yourself freely in a safe environment:
emotionctl write
Or capture a specific moment:
emotionctl write --title "The day everything changed"
Review your emotional progress:
emotionctl read
Find entries from difficult days:
emotionctl read --list
Look back at a specific moment:
emotionctl read --date 2025-07-02
Search for growth patterns:
emotionctl read --search "healing"
emotionctl read --search "breakthrough"
emotionctl read --search "stronger"
Delete an entry:
emotionctl delete --id <entry-id>
Create a backup:
emotionctl backup --output ~/my-journal-backup.json
Restore from backup:
emotionctl restore --input ~/my-journal-backup.json
Change your password:
emotionctl change-password
⚠️ WARNING: This permanently deletes all journal data!
emotionctl reset
Run without any commands for interactive mode:
emotionctl
yarn dev - Run in development mode with ts-nodeyarn build - Build the TypeScript projectyarn watch - Build in watch modeyarn test - Run testsyarn lint - Run ESLintyarn format - Format code with Prettiersrc/
├── index.ts # Main entry point and CLI setup
├── types/
│ └── index.ts # TypeScript type definitions
└── services/
├── AuthManager.ts # Password and authentication management
├── CryptoService.ts # Encryption/decryption utilities
├── JournalManager.ts # Journal entry management
├── CLIInterface.ts # User interface and interaction
└── Editor.ts # Journal Editor
~/.emotionctl/~/.emotionctl/
├── auth.json # Encrypted authentication data
├── config.json # Journal configuration
└── entries.json # Encrypted journal entries
MIT License - see LICENSE file for details
"Journal not initialized"
emotionctl init to set up your journal"Authentication failed"
"Permission denied"
If you encounter issues:
This application is designed for personal use and stores all data locally. While it uses strong encryption, please consider:
For sensitive information, consider using additional security measures like full-disk encryption.
FAQs
A secure terminal-based journaling system designed as a safe space for developers going through heartbreak, breakups, or betrayal
The npm package emotionctl receives a total of 1 weekly downloads. As such, emotionctl popularity was classified as not popular.
We found that emotionctl demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Node.js has paused its bug bounty program after funding ended, removing payouts for vulnerability reports but keeping its security process unchanged.
Security News
The Axios compromise shows how time-dependent dependency resolution makes exposure harder to detect and contain.
Research
A supply chain attack on Axios introduced a malicious dependency, plain-crypto-js@4.2.1, published minutes earlier and absent from the project’s GitHub releases.