Skip to main content

Awesome minimalist command line ticket/bug tracker based on ReStructuredText

Project description

Friendly and very light weight tool to keep track of list of things. Designed with bugs/tickets/GTD in mind

See some generated Bug file


Key features

  • CLI (works in a terminal)
  • Simple text file used as storage (ReStructuredText)
    • Git, Mercurial & co friendly
    • Colorized in the terminal
    • No need to edit the text file by hand
  • Automatically detects the “root” folder to use by finding .hg, .svn or other version manager folder in parent directories
  • More advanced features not getting in your way if you don’t need them:
    • Priorities
    • Tags
    • Attributes
    • Time tracker (counts the time spent on a given task)
  • Web Server allowing real-time read only sharing of the list
  • HTML export
  • Search tool (grep-like)

On the technical side

  • Pure Python, no dependency required (Ok… docutils, but misses it ? ;)
  • Simple one file design, keeping things short
  • No database, only the .rst file is used for storage


The command line tool is br and works in the current directory. If you don’t like this, feel free to edit br file and change the following lines to absolute paths:

BUGFILE = 'bugs.rst'
DONEFILE = 'fixed_bugs.rst'

List bugs:


Add new bug:

br new

Delete bug number 4:

br rm 4

Add one comment:

br add 3

Show full description of current bugs:

br show

Show description of some specific bug:

br show 42

Produce an html report:

br html > bugs.html

Start a web server on port 5555:

br serve

Change priority of item #66 (using bugid instead of item position):

br set #66 priority 10

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
bugrest-1.1.1-py2.7.egg (13.1 kB) Copy SHA256 hash SHA256 Egg 2.7
bugrest-1.1.1-py2-none-any.whl (15.0 kB) Copy SHA256 hash SHA256 Wheel 2.7
bugrest-1.1.1-py3.6.egg (13.1 kB) Copy SHA256 hash SHA256 Egg 3.6
bugrest-1.1.1-py3-none-any.whl (15.0 kB) Copy SHA256 hash SHA256 Wheel 3.6
bugrest-1.1.1.tar.gz (8.6 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page