Metadata-Version: 2.3
Name: tarvo
Version: 0.1.0
Summary: read-only api clients for jira, github, slack, and similar services
Requires-Dist: httpx>=0.28.1
Requires-Dist: pydantic-settings>=2.14.1
Requires-Python: >=3.13
Description-Content-Type: text/markdown

# tarvo

`tarvo` is an intentionally small and narrow tool to make read-only queries of Jira, Github, and other services. It exists specifically to allow Agentic access to remote APIs in cases where MCP is specifically disallowed. Installation is:

    uv add tarvo

There is a `.env.example` file that should be copied to `.env` and then edited to contain the credentials tarvo needs. Then running

    tarvo doctor

will check the .env file completeness and run a small test query of the remote services.

## Jira subcommands

    tarvo jira get <KEY>
    tarvo jira query [JQL] [--max-results N]

Examples:

    tarvo jira get TARV-123
    tarvo jira query 'status = "To Do"' --max-results 5
