A lightweight, cross-platform terminal task manager with tag support and cloud sync.

• Cross-platform: Works on Linux, Windows (CMD/PowerShell), and macOS
• Persistent storage: SQLite database with automatic timestamping
• Cloud-ready: Use any cloud-synced folder for your task database
• Link support: Store and open URLs/file paths directly
• Tag system: Organize tasks with tags and filter by tag
• Interactive mode: Navigate, complete, delete, update, and filter tasks with keyboard
• Simple CLI: Intuitive command-line interface

• Python 3.x
• rich library
• SQLite (included with Python)

Install dependencies:

pip install -r requirements.txt

cd /path/to/servante
python setup.py

cp servante.py ~/.local/bin/servante
chmod +x ~/.local/bin/servante

Add to PATH (add to ~/.bashrc or ~/.zshrc):

export PATH="$PATH:$HOME/.local/bin"

mkdir %APPDATA%\Servante
copy servante.py %APPDATA%\Servante\servante.py

Add to PATH (run as Administrator or via System Settings):

setx PATH "%PATH%;%APPDATA%\Servante"

Alternatively, create a batch file servante.cmd in a PATH directory:

@python "%APPDATA%\Servante\servante.py" %*

Note: To run servante from anywhere and use the shell aliases, the script location must be in your system PATH.

# Add a simple task
servante add "Finish the report"

# Add task with link and tags
servante add "Research API" -l "https://example.com" -t "work dev"

# List pending tasks (interactive mode)
servante list

# List all tasks (including completed)
servante list --all

# Mark task as completed
servante complete 1

# Update task link and/or tags
servante update 1 -l "https://newlink.com" -t "urgent"

# Remove task
servante remove 1

# Open link associated with task
servante open 1

# Search tasks
servante search "report"

When running servante list:

Default location: ~/.servante/tasks.db

# Set custom path via environment
export SERVANTE_DB="$HOME/Nextcloud/tasks.db"

# Or specify per-command
servante --db ~/Nextcloud/tasks.db list

# Add to ~/.bashrc or ~/.zshrc
alias s='servante'
alias sl='servante list'
alias sa='servante add'

# Add to $PROFILE
function s { servante $args }
function sl { servante list $args }
function sa { servante add $args }

servante --db ~/work.db list
servante --db ~/personal.db list

Servante works great in a quake/drop-down terminal (like Yakuake, Guake, or iTerm2's hotkey window). Bind servante list to your quake terminal for instant task access with a single keypress.

Contributions are welcome! Feel free to:

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

This project is a learning activity for me to get better with so called AI coding tools and it was created mainly by prompting. Tools and Models used:

• crush: Xiaomi: MiMo-V2-Flash Free (Initial build)
• claude: Sonnet and Opus 4.5 (Refactoring, improved features and finishing touches)
• codex: GPT 5.2 Codex (Code review)

This project is licensed under the MIT License - see the LICENSE file for details.