Topdog Simple
Intelligent infinite loop driver for Claude Code with proper completion detection, configurable timeouts, and multiple execution modes.
Installation
pip install topdog-simple
Usage
topdogsimple
The tool will continuously cycle through three prompts:
- "write helloworld.md and say hi and then stop"
- "How can you prove it?"
- "Please run tests and fix"
Configuration
Set environment variables to customize behavior:
export CLAUDE_TIMEOUT=600 # 10 minutes (default: 300s)
export CLAUDE_HEARTBEAT_TIMEOUT=120 # 2 minutes (default: 60s)
export CLAUDE_USE_SDK=true # Use Python SDK (default: false)
Features
- Intelligent Completion Detection: JSON streaming analysis + process monitoring
- Configurable Timeouts: Environment variable control for long-running tasks
- SDK Support: Optional claude-code-sdk integration for better control
- Heartbeat Monitoring: Detects hung vs. working processes
- Manual Override: Ctrl+C to skip hung processes without stopping the loop
- Automatic Configuration: Creates
.claude/files with full permissions - Persistent Context: Maintains session state across prompts
Manual Controls
- Ctrl+C once: Skip current prompt and continue to next
- Ctrl+C twice: Exit the entire loop
SDK Mode
Install the SDK for enhanced reliability:
pip install claude-code-sdk
export CLAUDE_USE_SDK=true
topdogsimple
1 maintainer
Metadata
1 maintainer
Release files for topdog-simple 0.5.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| topdog_simple-0.5.0.tar.gz | 14.5 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| topdog_simple-0.5.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 28.2 kB
Release files / topdog_simple-0.5.0.tar.gz
| Download URL | topdog_simple-0.5.0.tar.gz |
|---|---|
| Size | 14.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
737f7ef4a324d58a4a1dc90999ce3d66a83ab581c37ec99d2b0244b8e00d35cf
|
|
BLAKE2b-256 checksum How to use checksums |
e2ae43ee6c4af8540ed4ff804ed880d3dbac5c2bc3cf9b906ca71c95271ecaa9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.10.17
|
Release files / topdog_simple-0.5.0-py3-none-any.whl
| Download URL | topdog_simple-0.5.0-py3-none-any.whl |
|---|---|
| Size | 13.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
4346d8c65ee2cbf77ef00cf7e437791264bf4e28c8c256e67d6d419d097fcfb1
|
|
BLAKE2b-256 checksum How to use checksums |
7fab7da1f295c2a4debf70156fd0581d5cdc97fc0bb5880516050b5d60c98651
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.10.17
|
