# claude-progress
A lightweight progress tracker for `claude -p` command that shows thinking time, turn counts, and content previews.
## Features
- 🔄 Animated progress spinner
- ⏱️ Elapsed time tracking
- 🔢 Turn counter
- 👀 Content preview during thinking
- 🎯 Clean output
- 🚀 Zero dependencies - uses only Python standard library
## Installation
### Direct Usage (Recommended)
Clone the repository and use the script directly:
```bash
git clone https://github.com/time4wiley/claude-progress.git
cd claude-progress
./claude_progress.py "Your question here"
```
### Via pip/uv
```bash
# Using pip
pip install claude-progress
# Using uv
uv pip install claude-progress
```
## Usage
```bash
# Default usage (uses opus model)
./claude_progress.py "What is the meaning of life?"
# No quotes needed for multi-word queries
./claude_progress.py explain how git rebase works
# Override model (default is opus)
./claude_progress.py --model sonnet "Complex mathematical proof"
# All arguments after flags are joined as the query
./claude_progress.py tell me about quantum computing in simple terms
```
## Configuration
### Claude Binary Location
The tool automatically searches for the `claude` binary in:
1. `$CLAUDE_PATH` environment variable (if set)
2. System PATH
3. Common locations (`/usr/local/bin/claude`, `~/bin/claude`, etc.)
To specify a custom location:
```bash
export CLAUDE_PATH=/path/to/your/claude
```
## How It Works
`claude-progress` wraps the `claude -p` command and:
1. Automatically adds required flags: `--output-format stream-json --verbose`
2. Parses the streaming JSON output
3. Displays an animated progress indicator with:
- Elapsed time
- Turn counter
- Preview of Claude's current thinking
4. Shows clean final output
5. Reports completion statistics
## Integration with Shell
If you're using the App.configs setup, this tool integrates seamlessly with existing `cl` and `cls` aliases when the `-p` flag is used.
## Requirements
- Python 3.9 or higher
- `claude` CLI installed and accessible
## License
MIT License - See [LICENSE](LICENSE) file for details.
## Author
Created by Wei ([time4wiley](https://github.com/time4wiley))
Raw data
{
"_id": null,
"home_page": null,
"name": "claude-code-goodies",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "claude, cli, progress, ai, assistant, tools, utilities",
"author": null,
"author_email": "sharedsky <your.email@example.com>",
"download_url": "https://files.pythonhosted.org/packages/e4/d3/c3ed48f8b89da4897642f96cb233b538f67193f2daee89eef4c8f01adde6/claude_code_goodies-0.1.0.tar.gz",
"platform": null,
"description": "# claude-progress\n\nA lightweight progress tracker for `claude -p` command that shows thinking time, turn counts, and content previews.\n\n## Features\n\n- \ud83d\udd04 Animated progress spinner\n- \u23f1\ufe0f Elapsed time tracking \n- \ud83d\udd22 Turn counter\n- \ud83d\udc40 Content preview during thinking\n- \ud83c\udfaf Clean output\n- \ud83d\ude80 Zero dependencies - uses only Python standard library\n\n## Installation\n\n### Direct Usage (Recommended)\n\nClone the repository and use the script directly:\n\n```bash\ngit clone https://github.com/time4wiley/claude-progress.git\ncd claude-progress\n./claude_progress.py \"Your question here\"\n```\n\n### Via pip/uv\n\n```bash\n# Using pip\npip install claude-progress\n\n# Using uv\nuv pip install claude-progress\n```\n\n## Usage\n\n```bash\n# Default usage (uses opus model)\n./claude_progress.py \"What is the meaning of life?\"\n\n# No quotes needed for multi-word queries\n./claude_progress.py explain how git rebase works\n\n# Override model (default is opus)\n./claude_progress.py --model sonnet \"Complex mathematical proof\"\n\n# All arguments after flags are joined as the query\n./claude_progress.py tell me about quantum computing in simple terms\n```\n\n## Configuration\n\n### Claude Binary Location\n\nThe tool automatically searches for the `claude` binary in:\n1. `$CLAUDE_PATH` environment variable (if set)\n2. System PATH\n3. Common locations (`/usr/local/bin/claude`, `~/bin/claude`, etc.)\n\nTo specify a custom location:\n```bash\nexport CLAUDE_PATH=/path/to/your/claude\n```\n\n## How It Works\n\n`claude-progress` wraps the `claude -p` command and:\n1. Automatically adds required flags: `--output-format stream-json --verbose`\n2. Parses the streaming JSON output\n3. Displays an animated progress indicator with:\n - Elapsed time\n - Turn counter\n - Preview of Claude's current thinking\n4. Shows clean final output\n5. Reports completion statistics\n\n## Integration with Shell\n\nIf you're using the App.configs setup, this tool integrates seamlessly with existing `cl` and `cls` aliases when the `-p` flag is used.\n\n## Requirements\n\n- Python 3.9 or higher\n- `claude` CLI installed and accessible\n\n## License\n\nMIT License - See [LICENSE](LICENSE) file for details.\n\n## Author\n\nCreated by Wei ([time4wiley](https://github.com/time4wiley))\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A collection of useful tools for Claude AI, including a progress tracker for claude -p command",
"version": "0.1.0",
"project_urls": {
"Homepage": "https://github.com/time4wiley/claude-code-goodies-in-python",
"Issues": "https://github.com/time4wiley/claude-code-goodies-in-python/issues",
"Repository": "https://github.com/time4wiley/claude-code-goodies-in-python"
},
"split_keywords": [
"claude",
" cli",
" progress",
" ai",
" assistant",
" tools",
" utilities"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "d6c4f66e5d8c263338dc49b0e7681872aa66bd117b73a5fe6b57f1cff5560617",
"md5": "cda4ff70fbcede9059317d3b9342cbf6",
"sha256": "0564298abfb24ca729e1b0362eb8cf63aaabf3d2a7cabccea66e27ac70197048"
},
"downloads": -1,
"filename": "claude_code_goodies-0.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "cda4ff70fbcede9059317d3b9342cbf6",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 6749,
"upload_time": "2025-08-02T05:11:19",
"upload_time_iso_8601": "2025-08-02T05:11:19.067071Z",
"url": "https://files.pythonhosted.org/packages/d6/c4/f66e5d8c263338dc49b0e7681872aa66bd117b73a5fe6b57f1cff5560617/claude_code_goodies-0.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "e4d3c3ed48f8b89da4897642f96cb233b538f67193f2daee89eef4c8f01adde6",
"md5": "00a7cbedfd1108074230ef43001bf4eb",
"sha256": "2521f116113eafe04bfd081fabc863470f35969df7690d37cf718c4d1247242f"
},
"downloads": -1,
"filename": "claude_code_goodies-0.1.0.tar.gz",
"has_sig": false,
"md5_digest": "00a7cbedfd1108074230ef43001bf4eb",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 6932,
"upload_time": "2025-08-02T05:11:20",
"upload_time_iso_8601": "2025-08-02T05:11:20.559183Z",
"url": "https://files.pythonhosted.org/packages/e4/d3/c3ed48f8b89da4897642f96cb233b538f67193f2daee89eef4c8f01adde6/claude_code_goodies-0.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-02 05:11:20",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "time4wiley",
"github_project": "claude-code-goodies-in-python",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "claude-code-goodies"
}
JSON
