Skip to content
Oculus is a social SQL client for business intelligence.
Ruby CSS JavaScript
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
lib Fix display of null values Jun 20, 2012
spec Make QueryPresenter assertion explicit Jun 22, 2012
.gitignore Initial commit Mar 15, 2012
.travis.yml Travis should skip the demo branch May 31, 2012 Fix CHANGELOG formatting Jun 19, 2012
Gemfile Move sequel gem to development dependencies Jun 19, 2012
LICENSE Initial commit Mar 16, 2012 Remove reference to MySQL from README Jun 5, 2012
oculus.gemspec Move sequel gem to development dependencies Jun 20, 2012


The Oculus of the Pantheon

Build Status Dependency Status

Oculus is a web-based logging SQL client. It keeps a history of your queries and the results they returned, so your research is always at hand, easy to share and easy to repeat or reproduce in the future.

Oculus will not prevent you from doing stupid things! I recommend using a readonly SQL account.


$ gem install oculus
$ gem install mysql2 # to enable MySQL support
$ gem install pg     # to enable Postgres support


Oculus is a Sinatra app. Run it from the command line, or mount Oculus::Server as middleware in your Rack application (recommended). For more information on mounting Oculus as middleware, see the wiki: Running with Rack.

For details on command line options, run:

oculus --help


  1. Fork it
  2. Run rake db:test:populate
  3. Make your changes
  4. Run tests (rake)
  5. Send me a pull request

If you're making a big change, please open an Issue first, so we can discuss.

Something went wrong with that request. Please try again.