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). With a query, be concrete. The best form is one sentence listing several specific topics (AI agents for equity research, earnings analysis and risk): the server splits it into those topics, keeps an item that matches any one of them, and marks each item with the topics it matched. A single concrete question also works (KV cache eviction for long-context inference). The worst form is one medium-width field name (LLM evaluation): it fills the page with loosely related items and crowds out narrower topics. For a broad, exploratory topic use tycho search --since, which ranks instead of filtering. Write the query in English when you can: the corpus is English, and a query in another script is translated on the server first. --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.