WorkBack

Find the root cause of bugs using logs and github issues, instantly.

Installation

pipx install workback

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

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

Here are some real-world examples of root cause analysis performed by WorkBack on open source projects:

Analysis of a race condition in Parabol's meeting timer implementation causing unexpected resets.

View Analysis →

Investigation of task execution failures in Puppet Bolt's parallel operation mode.

View Analysis →

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

View Analysis →

All analysis reports are automatically saved in:

~/.workback/reports

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.

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

APIs:

Storage:

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