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.

Files for bugrest, version 1.1.1
Filename, size File type Python version Upload date Hashes
Filename, size bugrest-1.1.1-py2.7.egg (13.1 kB) File type Egg Python version 2.7 Upload date Hashes View
Filename, size bugrest-1.1.1-py2-none-any.whl (15.0 kB) File type Wheel Python version 2.7 Upload date Hashes View
Filename, size bugrest-1.1.1-py3.6.egg (13.1 kB) File type Egg Python version 3.6 Upload date Hashes View
Filename, size bugrest-1.1.1-py3-none-any.whl (15.0 kB) File type Wheel Python version 3.6 Upload date Hashes View
Filename, size bugrest-1.1.1.tar.gz (8.6 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page