Kosha (कोश) is Sanskrit for "treasury, storehouse": where all the
tools are kept.
Vayu's tools each live in their
own repository: the Vyom panels
and their fourteen tools, nāda,
dvarapala,
sangam, and whatever comes
next. That keeps each one independent, but leaves you with many clones to
keep track of. kosha does it for you: it knows where each tool goes,
installs its newest release, installs what it depends on first, checks
for updates in one go, shows the changelog when it updates, and lets you pin
a version or work on a tool from your own checkout.
Contents
Features
- One list of everything:
kosha list shows every package, the version
you have, the newest release, and whether it's pinned, linked or out of date.
- Released versions: installs and updates move between release tags
(
v0.1.4), never onto unreleased commits. kosha install [email protected]
installs and pins an older one.
- Dependencies first: installing a Vyom tool installs Vyom; removing
Vyom is refused while a tool needs it.
- See what's new before you update:
kosha fetch asks GitHub for the
newest package list and every package's newest release (metadata only,
nothing on disk changes) and shows each installed package next to
GitHub's: updates, development checkouts with unreleased commits, and
what the package list added or changed. Then kosha update installs.
- Updates that tell you what changed:
kosha update updates everything
in parallel and prints each tool's changelog since your version.
- Adopts what's already there: tools you cloned by hand (or an older
installer did) are recognised and managed as they are, nothing re-downloaded.
- Safe with your work: a clone with local changes is never updated or
removed without
--force, and --force stashes rather than discards.
- Develop in place:
kosha link nada ~/code/nada runs your checkout
instead of the release; kosha unlink nada puts the release back.
- System packages: when a tool needs a program you don't have, kosha says
which, and on Arch offers to install it (through
dvarapala when it's there).
- Scriptable:
kosha list --json, kosha fetch --json, kosha outdated --json, meaningful
exit codes, NO_COLOR respected.
- No dependencies beyond git and Python 3.11's standard library.
Install
curl -fsSL https://raw.githubusercontent.com/Theyashsawarkar/kosha/main/install.sh | bash
It clones kosha into ~/.local/share/kosha, links ~/.local/bin/kosha,
and needs no root. Or by hand:
git clone https://github.com/Theyashsawarkar/kosha ~/.local/share/kosha
ln -s ~/.local/share/kosha/bin/kosha ~/.local/bin/kosha
kosha install kosha # kosha manages itself from now on
Then install what you want, e.g. the launcher, the calculator and the music player:
kosha install dvara ganit nada
Usage
kosha help shows every command, grouped, with examples; kosha help <command>
(or kosha <command> --help) explains one. A typo gets a suggestion.
kosha help [<command>] every command, or one in detail
kosha list [--installed] [--json] packages: installed version, newest release
kosha search <words> find packages by name or description
kosha info <pkg> details, where it lives, what it needs
kosha install <pkg>[@version] ... install (newest release, or a pinned one) with its dependencies
kosha update [<pkg> ...] [--force] update to the newest release (everything, without names)
kosha fetch [--json] ask GitHub what's new, show how it differs from yours (changes nothing)
kosha outdated [--json] what has a newer release
kosha remove <pkg> ... uninstall
kosha pin <pkg> | unpin <pkg> keep a package on its version / let it update again
kosha link <pkg> <path> | unlink <pkg> use a development checkout in place of the release
kosha changelog <pkg> [<from>] what changed (since a version)
kosha doctor check every installed package
kosha refresh download the newest package list
kosha self-update update kosha itself
kosha completions zsh|bash tab completion for commands and packages
Options: -y/--yes (don't ask), -v/--verbose (every step and git command), -q/--quiet, -r/--refresh (ask GitHub now),
--json (list, fetch, outdated), --no-color (or NO_COLOR=1)
Every step shows a live row per package (what it's doing now, then its
result and time). Install, update and remove check each package, show a table
of what will happen, and ask before doing it:
This is the beginning of the README. Read the rest at the original. Read the full README ↗
