Bug is a simple todo-tracking system for the unix commandline.
It's written in POSIX sh, and it only requires the typical Unix utilities: grep, cut, tr, ...
It should probably work with a small busybox.
The lack of dependencies was the biggest motivation for its development.
Its database format is a text file containing simple tabbed columns which can be even hand-edited.
It uses $EDITOR for submitting or editing the issues and for changing states or priorities.
It relies on four fixed fields: ID, Priority, State, and Subject.
There is also a fifth free-text field for any other information you may want to store about the issue.
There is no database locking or notifications, so it's mostly for tracking the user's own issues.
You can look at a screenshot if you want.
Download the latest version (licensed under GPL 3 or later): bug.gz - v1.1 (The manual is in the header of the file)
Look at the version repository1 if you are interested in its development.
Copy of the manual at v1.1
- Your
$BUG_PROJECTshould point to a file. It will be the database you'll be using. Use an absolute path. It may be, for instance,~/todo.bug
- Create the database:
bug create
- Add an issue
Use integers for the priorities. Higher -> more priority. Use any words you prefer for the state Don't break the number of lines until "-- Description --". Write multilines only below that label.
bug add
- List the issues (all but description, priority sorted)
bug list # | grep as_you_wish - View an issue
bug view
- Edit an issue
Change the state, the priority, add data as long as you fix it... When I consider an issue is fulfilled, I negate its priority.
bug edit
- Delete an issue
Do that whenever you will not need the issue anymore.
bug delete
Original Author: Lluís Batlle i Rossell, viric@vicerveza.homeunix.net
Footnotes
-
This was originally hosted at https://viric.name/~viric/cgi-bin/hgwebdir.cgi/bug However, this link is now dead and no copy of it was available on the internet archive. ↩