WorkBack

Resolve bugs with a root cause and proof.

Installation

pipx install workback

Usage

1. Set Claude API key:

echo "{{CLAUDE_API_KEY}}" > ~/.workback/api_key

2. Navigate to your project:

cd path_to_your_project

3. Launch:

workback main

4. Start with logs or github issues to find the root cause:

/analyze /var/log/system.log

5. Setup GitHub (only required for /github command):

echo "{{GITHUB_TOKEN}}" > ~/.workback/github_key

6. Analyze GitHub Issues:

/github https://github.com/ParabolInc/parabol/issues/11258

Examples

Here are some real-world examples created by WorkBack on open-source projects:

Bolt Task Failures

Investigation of an infinite recursion bug when serializing errors with circular references.

View Root Cause → View PR →

InfluxDB Timestamp Precision

Analysis of replication failures with high-precision timestamps in InfluxDB.

View Root Cause →

Reports

All analysis reports are automatically saved in:

~/.workback/reports

Interactive Help

When WorkBack needs a specific file:

/resume /absolute/path/to/file

Use this when WorkBack asks for files from libraries or other repositories.

When WorkBack has a question:

/answer Your response to the question

Use this to provide additional context or clarification when asked.

Security

WorkBack runs entirely between you and your private Claude API key. For questions or to report issues, contact [email protected].

About

Connect GitHub X LinkedIn Blog
Contact [email protected] [email protected]
Team Priyank Chodisetti Arthur Gousset