npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

astreus-cli

v0.8.1

Published

Command-line client for Astreus, the financial data terminal that turns the world's financial disclosure into structured, traceable data — statements, segments, filings and note tables, decks, transcripts, guidance, events, news, ownership, macro, the cla

Readme

astreus

astreus — Astreus from the terminal. Astreus is the financial data terminal that turns the world's financial disclosure — filings, results announcements, investor decks, earnings calls, 8-Ks and central-bank text across the US, the Gulf, Japan, Taiwan, Korea and Europe — into structured, traceable data: standardized statements, segments and KPIs, note tables, transcripts, management guidance, events, news, ownership, macro, markets and the causal claim graph, with the source filing printed under every number. It also serves what companies physically own and operate — fabs, data centres, power plants, malls, stores — as data: where each asset is, its status, its capacity and its sources.

npm install -g astreus-cli
astreus coverage                  # what is covered, market by market — no key needed
astreus login                     # hidden prompt; key validated before it is saved
astreus financials NVDA           # standardized income statement, cited
astreus assets TSM                # TSMC's fabs: location, status, process nodes
astreus fact-source NVDA std:revenue 2025-01-26
astreus financials XDFM000001     # Emaar (DFM), from its IFRS statements
astreus transcript NVDA | less    # the most recent call on file
astreus --json company NVDA | jq  # the raw API payload, verbatim

Node 22.12 or later. No native modules. The published binaries bundle their runtime dependencies.

What it does well

  • Citations by default. Any command that prints a financial figure ends with a source: line — accession, period, basis — and astreus fact-source is one keystroke away for any cell.
  • Fills in what the raw API makes you look up. astreus transcript NVDA resolves the transcript id and its required date from the index; astreus event NVDA <accession> resolves the 8-K item code.
  • Built for scripts and agents. --json is exactly one JSON document on stdout; stderr carries everything else; exit codes are stable (astreus help exit-codes); text endpoints stream so they pipe.
  • Versioned contract. The build embeds the SHA-256 of the OpenAPI contract and fails if the local spec changed; astreus --version prints the hash. Server and npm releases are separate: compare deployed discovery before assuming they match.
  • Nulls are never zeros. — means unavailable or withheld; the response alone may not explain why.

Full API access

api list / describe / call reach every operation in the contract, including endpoints without a dedicated formatting command:

astreus --json api list --search calendar
astreus api describe get-fx-reference-rates
astreus --json api call get-fx-reference-rates --query base=USD --query codes=AED,SAR
astreus --json api call get-company-profile --path id=XDFM000002

Use the exact operation ID from api list. Repeat --path name=value and --query name=value; use --body '{...}' or --body @request.json for POST calculations and --output file for media. Unknown operations and misspelled or invalid parameters fail before a request is sent. api describe includes the request body schema. The news stream uses news --follow; browser recording-state writes are excluded from data calls. Data endpoints retain their authentication, entitlements and quotas.

Commands

astreus --help lists them all. Groups:

| Group | Commands | | --- | --- | | Auth & meta | login, logout, auth status, me, health, stats, coverage, docs, llms, completion (bash, zsh, fish, powershell) | | Comparing companies | comps <names or ids...> (a table of companies against metrics in one call: multiples, margins, growth, statement lines by fiscal year or trailing twelve months, with median and mean; --peers-of <id> for a company and its peers, --cols (pe_ttm,fy:revenue,fy:revenue@-1,ttm:revenue), --year 2024 or --ttm for the whole table, --derive, --sort, --columns [statement] to list the columns) | | Physical assets | assets <id> (a company's fabs, data centres, plants, malls, stores: country, state and city, coordinates, status, capacity, roles; --kind, --status, --country, --region, --city, --former), asset <key> (one asset: parties over time, lifecycle, sources; --data for everything measured, --frames for its satellite pictures, --frame <capture> -o to download one), asset-stats <id> [section] (megawatts per data centre, fab capacity, plant output, contracts, build timelines; --part, --site), geo companies / geo layers (who and what is covered), geo features --countries OM --layers maritime.ports (every company's assets in a place) | | Companies | search, company, companies, prices, segments, regions, dividends, calendar, capital-structure, management, compute, logo, market-events, assets, asset, research (filing diff, XBRL x-ray, data confidence), private (private companies, --filed) | | Financials | financials, as-filed (--printed [--period] for one period's printed table), fact-source, monthly-revenue | | Ratings & competitors | credit-ratings (S&P, Moody's, Fitch issuer ratings and recorded actions), analyst-ratings (published broker ratings and targets), competitors (by product line, --product) | | Filings & 8-K | filings, filing, sections, section, note-tables, note-table, note-series, events, event, wire, observations | | Calls & guidance | transcripts, transcript (--timeline), guidance, earnings (--statements), observation, presentations, deck-page, deck-guidance | | Ownership & people | ownership (--insider-history, --foreign-history), people, person (--votes) | | Places & series | place (everything held for a country, region or city: its map, --topic, --query), compare (one indicator across places, --places, --within), series (the numbers of up to 12 series), fetch (open any typed id a result gave), guide (how to use the data, by topic) | | Macro | countries, macro (--catalog, --economy, --central-bank, --government, --regions; macro AE-DU <KEY> for a region), macro-series <id>, policy, fed-financials (--source, --document -o) | | Markets | indices, commodities, fx, crypto, debt (--issuers for the issuer screener), calendars (earnings --live, --coverage) | | World | conflicts, organisations, tracking, geo | | Intelligence | narratives, pulse, intel | | Analytics | catalog, chart | | Signals | signals (insider buying clusters, vote dissent, red-flag 8-Ks, board interlocks, 13F rotation) | | Transcript search | transcript-search (full text over every call, --summary, --topics, --facets), topic-trends, mentioned-by (where other companies name this one) | | Government | government (US views, --bills, --committee, --vote, --next-sitting, --budget-flow; elsewhere the entity registry, --entity <code> --series), judiciary, executive-orders, officials (--changes, --schedule), awards, regulation (--regulators, --central-bank), laws | | News | news — the attributed intraday tape, one company's tape (-c), search, --top, --follow | | MCP | mcp — serve the Astreus MCP tools over stdio, the same lists as the hosted server: 17 tools by default (the compact list of /api/mcp), or one typed tool per dataset with --full (61, as /api/mcp/full). Every tool name ever published is answered either way; tools/list is authoritative: claude mcp add astreus --env ASTREUS_API_KEY=pk_live_... -- astreus mcp |

Configuration

Key: --api-key → ASTREUS_API_KEY → ~/.config/astreus/config.json (0600). Origin: --base-url → ASTREUS_BASE_URL → config file → https://astreus.ai. The origin must be https (plain http only for localhost); the key is never sent to another origin, even on a redirect. The pre-rename ~/.config/prometheus file and PROMETHEUS_BASE_URL are no longer read. NO_COLOR is honoured; ASTREUS_CONFIG_DIR relocates the config file.

Exit codes

0 ok · 1 unexpected · 2 usage · 3 auth (401) · 4 payment (402) · 5 not found (404) · 6 rate limited / quota (429) · 7 server (5xx).

Development

npm run build      # gen types from ../web/public/openapi.json → tsup → spec-hash guard
npm test           # node:test — transport, config, formatting, descriptor DSL, and every
                   # command replayed against the OpenAPI examples
E2E_ENV_FILE=~/path/.env npm run test:e2e -- --base-url http://localhost:3000 [--only gulf]

Releasing (version bump, regenerate, build, e2e, publish with the founder's go-ahead): RELEASING.md.

Docs: https://doc.astreus.ai/cli. Licence: MIT.