Metadata-Version: 2.4
Name: tarvo
Version: 0.2.2
Summary: read-only api clients for jira, github, slack, and similar services
License-Expression: MIT
License-File: LICENSE
Requires-Dist: jira[cli]>=3.10.5
Requires-Dist: pydantic-settings>=2.14.1
Requires-Python: >=3.11
Project-URL: Homepage, https://github.com/esimplicityinc/tarvo
Project-URL: Issues, https://github.com/esimplicityinc/tarvo/issues
Description-Content-Type: text/markdown

![tarvo mascot](static/tarvo256.png)

# 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
