https://github.com/towry/agpod
agent tools. autonomy agent helper
https://github.com/towry/agpod
agent-autonomy agent-tools
Last synced: about 2 months ago
JSON representation
agent tools. autonomy agent helper
- Host: GitHub
- URL: https://github.com/towry/agpod
- Owner: towry
- License: mit
- Created: 2025-09-23T09:36:49.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2026-04-17T05:22:26.000Z (3 months ago)
- Last Synced: 2026-04-17T07:03:02.339Z (3 months ago)
- Topics: agent-autonomy, agent-tools
- Language: Rust
- Homepage:
- Size: 998 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project
README
# agpod
[](https://github.com/towry/agpod/actions/workflows/ci.yml)
[](LICENSE)
[](https://www.rust-lang.org)
`agpod` is a Rust CLI for three concrete workflows:
- minimize git diffs for LLM context
- track exploration work as structured cases
- print repository paths with Git or Jujutsu branch metadata
## Features
### Diff
- summarize oversized file diffs
- reduce empty-line noise while preserving patch structure
- optionally save review chunks with a `REVIEW.md` checklist
### Case
- open, redirect, close, and resume structured exploration cases
- record findings, decisions, blockers, and ordered execution steps
- emit machine-readable JSON and support MCP-based automation
### VCS Path Info
- append branch or bookmark metadata to paths
- filter to repository paths only
- fit shell pipelines such as `zoxide`, `fzf`, and custom prompts
## Installation
### From source
```bash
git clone https://github.com/towry/agpod.git
cd agpod
cargo build --release
```
Built binaries:
- `target/release/agpod`
- `target/release/agpod-mcp`
## Usage
### Diff
```bash
git diff | agpod diff
git diff | agpod diff --save
git diff | agpod diff --save --save-path custom/path
```
See [docs/SAVE_OPTION_SUMMARY.md](docs/SAVE_OPTION_SUMMARY.md).
### Case
```bash
agpod case open \
--goal "find the root cause" \
--direction "inspect the failing path first"
agpod case current
agpod case step add \
--id C-550e8400-e29b-41d4-a716-446655440000 \
--title "collect logs" \
--start
agpod case record \
--id C-550e8400-e29b-41d4-a716-446655440000 \
--kind evidence \
--summary "captured the failing request"
```
### VCS Path Info
```bash
echo "/path/to/repo" | agpod vcs-path-info
echo "/path/to/repo" | agpod vcs-path-info -f "{path} [{branch}]"
zoxide query --list | agpod vcs-path-info --filter -f "{path} [{branch}]" | fzf
```
## Configuration
Global config:
- `$XDG_CONFIG_HOME/agpod/config.toml`
- `~/.config/agpod/config.toml`
Repo-local override:
- `.agpod.toml`
Example:
```toml
version = "1"
[log]
level = "warning"
[diff]
output_dir = "llm/diff"
large_file_changes_threshold = 100
large_file_lines_threshold = 500
max_consecutive_empty_lines = 2
[case]
server_addr = "127.0.0.1:6142"
auto_start = true
access_mode = "local_server"
semantic_recall_enabled = false
vector_digest_job_enabled = false
[case.plugins.honcho]
enabled = false
sync_enabled = true
# base_url = "https://api.honcho.dev"
# workspace_id = "ws_123"
# api_key = "honcho_secret"
# api_key_env = "HONCHO_API_KEY"
```
See [examples/config.toml](examples/config.toml) and [docs/case-configuration.md](docs/case-configuration.md).
Environment variables still override file config. Common Honcho-related overrides:
- `AGPOD_CASE_HONCHO_ENABLED=true`
- `AGPOD_CASE_HONCHO_SYNC_ENABLED=true`
- `AGPOD_CASE_SEMANTIC_RECALL=true`
- `HONCHO_BASE_URL=https://api.honcho.dev`
- `HONCHO_WORKSPACE_ID=ws_123`
- `AGPOD_CASE_HONCHO_API_KEY=...`
- `AGPOD_CASE_HONCHO_API_KEY_ENV=HONCHO_API_KEY`
- `HONCHO_API_KEY=...`
Logs default to `warning` and are written under the platform data directory in `agpod/logs/`, for example `~/Library/Application Support/agpod/logs/agpod.log`, `agpod-case-server.log`, and `agpod-mcp.log`.
## Workspace
- `crates/agpod` - CLI entrypoint
- `crates/agpod-core` - shared configuration helpers
- `crates/agpod-diff` - diff minimization
- `crates/agpod-case` - exploration case tracker
- `crates/agpod-vcs-path` - VCS path formatting
- `crates/agpod-mcp` - MCP server for case workflows
## Development
```bash
cargo build
cargo test
cargo clippy --all-targets --all-features -- -D warnings
cargo fmt --all
```
## License
MIT. See [LICENSE](LICENSE).