Skip to content

Command reference ​

Every command and flag in CLI 0.5.27. gosset <command> --help prints the same information in your terminal.

bash
gosset --help
gosset --version        # or: gosset version
CommandWhat it doesPage
gosset drugsSearch drugs and therapeutic assetsdrugs
gosset trialsSearch clinical trialstrials
gosset companiesSearch companiescompanies
gosset dealsSearch licensing, M&A and financing dealsdeals
gosset newsSearch news and press releasesnews
gosset abstractsSearch conference abstracts across meetingsabstracts
gosset ptrsTrial progression estimate (PTRS) for one NCT idPredictions
gosset timelinePredicted primary-completion date for one NCT idPredictions
gosset schemaThe published field list for each entityschema
gosset usageHow much of each dataset your account has usedUsage & limits
gosset skillsAgent workflows bundled with the CLITeach your agent
gosset authSign in and store your API key. Aliases: login, get-keyGetting started
gosset get-tokenPrint an OAuth token for MCP clientsGetting started
gosset versionPrint the CLI version

The package also installs gosset-cli, an alias for gosset.

Flags on every entity command ​

drugs, trials, companies, deals, news and abstracts share these:

FlagDefaultMeaning
--limit N25Results per page. The server caps a page (usually 100) and warns when it does
--offset N0Rows to skip
--alloffFetch the whole set, paging for you, as one array. Refuses above 10,000 rows. Not with --offset
--sort FIELDper commandSort on a published field; prefix - for descending. Write --sort=-phase, with =
--fields a,b,call fieldsReturn only these fields (JSON and table)
--tableoffPrint a table instead of JSON
--jsononJSON output (the default; overrides --table)
--include-idsoffAdd id fields such as target_ids and disease_class_ids, for joining records
--where CONDnoneAny other condition, see Filtering with --where. Repeatable
--debugoffPrint the query object sent to the API, on stderr
--api-key KEYstored keyUse this key for this call
--base-url URLhttps://api.gosset.aiUse another API endpoint

Filters per entity command ​

gosset drugs [NAME] ​

FlagMeaning
NAMEDrug name, brand or code, resolved to the drug
--targetTarget name or id, e.g. PD-1
--diseaseDisease name or id, e.g. "atopic dermatitis"
--modalityModality name or id, e.g. mAb, ADC
--companyDeveloper name or id
--phasePreclinical, 1, 2, 3, 4, Approved, Discontinued (comma list)
--routeRoute(s) of administration
--actionagonist, antagonist, or an exact effect such as "Partial agonist"
--combinationnone, fixed_dose, mixture, co_administration (comma list)
--include-combinationsAlso return trial-arm regimens such as cisplatin + vinflunine, hidden by default
--industry-onlyCount only industry programs; needs --disease

Default sort: most advanced first (-phase).

FlagMeaning
SEARCHFree text: NCT id, acronym or title
--drug, --disease, --target, --sponsorName or id
--phase1, 2, 3, 4 (comma list)
--statusTrial status(es), e.g. Active, Completed, Terminated
--registryctg (default), eu_ctis, another registry code, or all
--since, --untilCompletion date range, YYYY-MM-DD
--industry-onlyTrials with an industry sponsor or collaborator
--has-resultsTrials with reported results

Default sort: latest completion date first (-completion_date).

gosset companies [NAME] ​

FlagMeaning
NAMECompany name, resolved to the company
--disease, --modalityName or id; matches the company's pipeline
--countryCountry name(s)
--typeCompany category, e.g. Biotech, "Big Pharma"
--stageCompany stage, e.g. "Phase 3", Commercial
--publicListed companies only

Default sort: latest funding round first.

gosset deals ​

FlagMeaning
--drug, --target, --diseaseName or id
--buyer, --sellerCompany name or id
--deal-typeDeal type(s), e.g. Licensing, "M&A", Fundraising
--since, --untilDeal date range, YYYY-MM-DD
--min-valueMinimum total deal value, USD

Default sort: newest first. No positional argument.

FlagMeaning
SEARCHFree text over title and summary
--drug, --disease, --companyName or id
--categoryCategory tag(s), e.g. Results, Approval, Conference
--since, --untilPublication date range, YYYY-MM-DD

Default sort: newest first.

FlagMeaning
SEARCHFree text over the abstract
--drugDrug name or id; matches every meeting
--disease, --target, --modalityName or id (target and modality of the primary drug)
--companyDeveloper of the primary drug
--conferenceSeries (ASCO), list (ASCO,ESMO) or one edition ("ASCO 2025")
--yearEdition year(s)
--nctLinked trial id(s)
--phaseFurthest phase of the primary drug, not of the study
--annotation-levelannotated or link_only
--min-impactMinimum impact score, 0 to 10
--since, --untilPresentation date range, YYYY-MM-DD

Default sort: newest first.

Other commands ​

gosset ptrs NCT_ID ​

FlagDefaultMeaning
--model-versionv3v3, or v4-rc for the current V4 model (v4-rc.6 names the same release)
--api-key, --base-urlAs above

gosset timeline NCT_ID ​

FlagDefaultMeaning
--as-of YYYY-MM-DDtodayPredict as if it were this date, for backtests
--api-key, --base-urlAs above

gosset schema [ENTITY] ​

No entity: list the entities and their field counts. With one of drugs, trials, companies, deals, news, abstracts: list its fields with a description each. Takes --api-key and --base-url.

gosset usage ​

FlagMeaning
--jsonPrint the full report as JSON
--api-key, --base-urlAs above

gosset skills [NAME] ​

FlagMeaning
NAMEA skill to print as Markdown. Today: competitive-landscape
--jsonThe catalog, or the skill with its metadata, as JSON

Works offline and without signing in.

gosset auth (login, get-key) ​

FlagMeaning
(none)Sign in in the browser and store the key
--manualSign in on a machine with no browser: prints a URL to open elsewhere
--code CODEFinish a --manual sign-in with the code the page shows
--statusShow whether you are signed in, and where the key comes from
--logoutRemove the stored key
--print-exportPrint export GOSSET_API_KEY=... instead of storing the key (CI)
--quietPrint only the key
--base-urlSign in against another API endpoint

gosset get-token ​

FlagMeaning
--quietPrint only the token
--base-urlAnother API endpoint

Prints an OAuth token for MCP clients. The CLI, the SDK and the REST API use the key from gosset auth instead.

Environment variables ​

VariablePurposeDefault
GOSSET_API_KEYAPI keythe stored key
GOSSET_OAUTH_TOKENUsed when GOSSET_API_KEY is not set
GOSSET_API_URLAPI base URLhttps://api.gosset.ai
GOSSET_CONFIG_DIRFolder that holds the stored key$XDG_CONFIG_HOME/gosset, else ~/.config/gosset
GOSSET_FORCE_MANUAL_AUTH1 makes gosset auth use the paste-the-code flow

Exit codes ​

CodeMeaning
0Success, including an empty result
1No API key, an API error, or a malformed flag value. The error is JSON on stderr
2A name you passed matched nothing; --all refused a set above 10,000 rows or was combined with --offset; or the command line itself is invalid (unknown flag, bad choice)
130Interrupted (Ctrl-C)

Gosset Documentation