Research & collaboration — alice

alice is OpenAlice's research and collaboration interface on your PATH. Output is JSON on stdout (pipe it: alice market search --query AAPL | jq '.results[0]'); a non-zero exit means it failed, with the reason on stderr.

Discover, don't guess

alice --help                       # discover research and collaboration groups
alice <group> <verb> --help        # a verb's flags (which are required)

Workbench research

Find a symbol (returns barIds — the operational handle for charts/quant):

alice market search --query "apple"

(Fundamentals, ratios, calendars and macro series live on traderhub — e.g. traderhub equity profile --symbol AAPL.)

Expand coverage with vendors. Symbol search — and the K-line sources it returns — comes from a set of data vendors; yfinance (global, always on) is the default. For a name a global vendor misses, like a CN A-share or a Taiwan stock by its native name, a local vendor closes the gap. List what's on and what each covers, then enable one — live on the next search, no restart:

alice market vendors                                    # sources, on/off, and how to use each
alice market vendor-set --vendor twse --enabled true    # Taiwan (TWSE/TPEx); `eastmoney` for CN A-shares

If a search for a non-US name comes up empty, check alice market vendors before giving up — the covering source may just be off. Each vendor's howToUse flags its quirks (e.g. twse wants 繁体 台積電, not 简体 台积电).

alice rss is an optional quick scan of collected subscription articles, with limited coverage. Command parameters are available in alice rss --help.

Raw K-lines use the same BarService as the Market chart. The market-data skill covers source discovery, raw data and chart references in replies:

alice market search-bars --query AAPL
alice market bars --bar-id 'yfinance|AAPL' --asset-class equity --interval 1d --count 250 --output bars.json

The JSON file contains bars and meta, suitable for local Python/JavaScript or shell pipelines. Omit --output for stdout. Existing files are preserved. Sources retain their own identity; inspect coverage and freshness metadata. alice analysis quant and snapshot remain optional conveniences; see the alice-analysis Skill for their formula syntax.

Workspace shells inherit their Alice Project automatically. Outside a Workspace, use openalice exec --project <key> alice <group> <verb> ...; omitting the selector uses the configured Project context/default. Explicit Project selection clears inherited Workspace/Session scope. Workspace collaboration commands need Workspace context.

Collaboration and durable assets

The same alice CLI also owns peer, conversation, inbox, issue, provenance, signature, session, track, and template. These are top-level groups, not an alice workspace subcommand.

Read the collaboration reference before sending messages, delivering reports or managing durable work. Workspace and Session identity are supplied by the launch context. Use live alice --help to discover commands and flags.