Installation¶

From PyPI (Recommended)¶

# Install from PyPI
pip install jott-cli

# Optional: Install with text-to-speech support
pip install jott-cli[tts]

# Verify installation
jott --version

From Source¶

# Clone the repository
git clone git@github.com:son1112/jot.git ~/projects/jot
cd ~/projects/jot

# Install in development mode
pip install -e .

# Optional: Install development dependencies for testing
pip install -e ".[dev]"

Manual Installation¶

# Clone the repository
git clone git@github.com:son1112/jot.git ~/projects/jot

# Make the script executable
chmod +x ~/projects/jot/jot.py

# Create an alias in your shell config (.zshrc, .bashrc, etc.)
alias jott='python3 ~/projects/jot/jot.py'

Optional Dependencies¶

MCP Server¶

For Model Context Protocol integration with Claude Code:

pip install jott-cli[mcp]

Text-to-Speech¶

For voice announcement support:

pip install jott-cli[tts]

Google Calendar¶

Google Calendar dependencies are included in the base install. See Features for OAuth setup instructions.

Documentation¶

To build the docs locally:

pip install -e ".[docs]"
make docs