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
tycho latest --scope article --since 24h
tycho latest "agent memory" --since 7d --page-size 10
tycho latest --area cs.LG --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 search "graph neural networks" --since 30d

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

Run tycho latest without a query for the plain timeline (feed). --since limits latest and search results to items published at or after the given instant and accepts a duration (24h, 7d), a date (2026-08-29, UTC midnight) or an ISO datetime. For search it only applies to the first page; drop --cursor and search again to change the window.

Pass a response's nextCursor as --cursor to page. A null nextCursor means there is no next page. tycho latest <query> may return a short page that still carries a cursor when its scan cap is reached (the trailing note says so); keep paging in that case.

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

tycho search "agent memory" --json

Run tycho help for an overview of the commands, and tycho help <command> (or tycho <command> --help) for a command's full description, options and examples. See docs/api/tycho-cli.md in the repository for the usage guide.