Black Box - development logger and problem solver

Nikhil M Jeby

View on GitHub →

Inspiration

Documentation is a very tedious process..

I believe there are 2 types of documentation on high level for a technical project.

Documentation for the end user. [applicable for almost all the projects]

  1. Technical documentation for the developers and maintainers. [applicable mostly for long-term
  2. projects] keeping comments in our code describing what it does is an example of 2nd type. I wanted to make the development journey easier by having a live documentation engine attached to our IDEs

What it does

I have created a VsCode extension, which is directly integrated to slack.

Features:

  1. settings screen to add custom bot tokens.
  2. need a git repo => uses the name of repo to create a repo channel in slack.
  3. documentation/ dev-logs of each file is represented as a thread in slack.
  4. tagging + filtering based on tags
  5. quick help tags
  6. OpenAI based code description
  7. For testing, Join My Workspace [default xapp and xoxb]: https://join.slack.com/t/hackathon-idea/shared_invite/zt-110gur9ac-k0k8eZeMwOl~~PxkOwCpXg

Get started

  1. Install the extension "Black Box"
  2. open any git repo in vscode [repo I used in demo => https://github.com/solid-droid/SimpleML]
  3. press CTRL + M
  4. to configure your own workspace, create a bot with permissions mentioned in the demo in your workspace => add the bot token(OAuth) and app token(websocket) in extension settings.

How we built it

  1. JavaScript based
  2. uses slack/web-api
  3. uses slack websocket
  4. openAI codex for code description

Try it in Marketplace