tycho-cli

tycho

tycho is the Tycho query API CLI.

Install

npm install -g tycho-cli

Configure

The default API endpoint is https://api.zhigeng.me. Set an API key before using the CLI:

export TYCHO_API_KEY=zg_xxx

Use TYCHO_BASE_URL only when you need to override the endpoint:

export TYCHO_BASE_URL=https://api.zhigeng.me

Local config is also supported:

tycho config set api-key zg_xxx
tycho config set base-url https://api.zhigeng.me
tycho config get

Usage

tycho areas

tycho latest "agent memory" --page-size 10
tycho latest --area ml --scope paper
tycho latest --author "Alice Chen"
tycho latest --institution "Stanford University" --scope paper

tycho search "graph neural networks"
tycho search "graph neural networks" --scope paper --page-size 10

tycho paper arxiv:2602.12312
tycho paper arxiv:2602.12312 --content section --path 3.1
tycho paper arxiv:2602.12312 --content evidence --query "how does it work?"
tycho related arxiv:2602.12312 --direction both --limit 20

By default, tycho requests Markdown from the query API. Use --json for the raw JSON response:

tycho search "agent memory" --json

See docs/api/tycho-cli.md in the repository for the full usage guide.