Use Caretz from the Terminal
Caretz works best when you give it a concrete task inside a project. Start in a repository and open an interactive session:
cd your-project
caretz
Try prompts like:
Explain how authentication works in this project.
Find the cause of the failing tests and fix it.
Add pagination to the users endpoint and test it.
Review my current changes for bugs and missing tests.
Caretz can inspect the repository, edit files, and run commands while keeping the
conversation open for follow-up requests. To see every tool result and token
counter, use caretz --output detailed. To change the colors, pick a
theme
.
Run One Task and Exit
Use -p for a task that does not need a back-and-forth conversation:
caretz -p "summarize the current git diff"
caretz -p "run the tests, fix the failure, and explain what changed"
caretz --prompt-file task.md
Start a prompt with ! to run a command in the sandbox without calling the
model. This works with -p and at the interactive prompt:
caretz -p '!go test ./...'
Work in Another Repository
You do not have to change directories first:
caretz --workspace ../another-project -p "review the latest commit"
Find More
The installed binary is the source of truth for available commands and options:
caretz --help
caretz session --help
Next: continue earlier work , hand over a goal , run a task on a schedule , or grant network access .