workback 0.1.0

An agentic debugging tool that lives in your terminal and helps you debug faster - all through natural language commands.

WorkBack

A terminal-based chat interface to help you debug your code using logs. Think Claude Code, but for debugging with logs.

Installation

We haven't published the package to PyPI yet, so you need to install it from source, sorry :/

1. Clone the repository:

   git clone https://github.com/hyperdrive-eng/workback.git
   

2. Navigate to the project you want to debug:

   cd path/to/project
   

3. Create and activate a virtual environment:

   python3 -m venv .venv
   source .venv/bin/activate
   

4. Install WorkBack in the virtual environment:

   pip install -e /path/to/workback
   

5. Set Claude API key

   echo "..." > ~/.workback/api_key
   

6. Launch WorkBack:

   workback
   

7. Deactivate the virtual environment when you're done

   deactivate
   

8. Delete the virtual environment if you no longer need it

   rm -rf .venv
   

Usage

• Ctrl+I - Interrupt
• Ctrl+C - Quit the application