Raven
| Type | CLI Tool |
| Status | stable |
| Language | Python |
| Version | v0.1.0 |
| Distribution | PyPI (odin-raven) |
| License | MIT |
| Repository | GitHub |
Overview
Raven is a semantic CLI wrapper around Git that replaces mechanical Git commands with intent-driven verbs.
Instead of typing git add . and git commit -m,
you use words like gather and mark —
language that describes what you mean, not what the machine expects.
Git remains the engine. Raven is the messenger.
Features
- Human-friendly aliases for common Git operations
- Intent-driven verbs inspired by Norse mythology
- Zero changes to underlying Git behaviour
- Installable via pip as
odin-raven - Lightweight with no heavy dependencies
- Full branch and history management support
Commands
Every Raven command maps directly to a Git equivalent. The translation is transparent — Git does the actual work.
| Raven Command | Git Equivalent | Meaning |
|---|---|---|
raven awaken |
git init |
Initialize repository |
raven watch |
git status |
Observe repo state |
raven gather |
git add . |
Stage changes |
raven mark "msg" |
git commit -m |
Record a commit |
raven fly |
git push |
Push changes |
raven sync |
git pull |
Sync with remote |
raven huginn |
git diff |
Think before acting |
raven muninn |
git log |
Recall history |
raven paths |
git branch |
View branches |
raven perch <branch> |
git checkout |
Switch branch |
raven spawn <branch> |
git checkout -b |
Create branch |
raven merge <branch> |
git merge |
Merge branch |
Core Workflow
A typical Raven session looks like this:
raven watch
raven gather
raven mark "feat: add new feature"
raven flyWhich translates directly to:
git status
git add .
git commit -m "feat: add new feature"
git pushMythology
In Norse mythology, Odin keeps two ravens — Huginn and Muninn — who fly across the world each day and return to report what they have seen.
- Huginn — Thought. Maps to
git diff: inspect before you act. - Muninn — Memory. Maps to
git log: recall what came before.
The project borrows this idea lightly — using it as a naming layer, not a theme to overload.
Installation
Raven is distributed on PyPI under the package name odin-raven.
pip install odin-raven
After installation, the raven command is available globally:
raven --helpDevelopment Notes
Raven started as a small experiment in making Git feel more intentional. The command set was kept minimal — only the operations that matter in a typical day-to-day workflow.
The project is stable at v0.1.0. Future additions may happen, or may not. It does what it needs to do.