# ForecastOS

> Ask your agent what is likely to happen. Without ForecastOS it guesses. With it, the agent checks Polymarket, Kalshi, and Precog before answering — and can discover, trade, or create prediction markets, including creating and funding a market to obtain real info when none is available.

ForecastOS is an agent skill plus the `forecast` CLI for Polymarket, Kalshi, and Precog. Browse (search, list, odds) needs no keys. Writes preview first; `--confirm` only after operator approval.

## Install

- Skill: `npx skills add https://github.com/precog-markets/forecast-os --skill forecast-os`
- Agent playbook: [/INSTALL.MD](/INSTALL.MD) — skill + CLI setup, trading credentials, safety rules, try-it prompts.
- CLI: checksum-verified `scripts/install.sh` inside the skill, or [GitHub Releases](https://github.com/precog-markets/forecast-os/releases).

## Docs

- [Agent install playbook](/INSTALL.MD): the full setup flow agents should follow.
- [Skill source](https://github.com/precog-markets/forecast-os): routing and agent defaults in `skills/forecast-os/SKILL.md`; workflows in `skills/forecast-os/workflows/` (`quote-and-buy.md`, `manage-positions.md`, `create-precog-market.md`, `fund-launchpad.md`); command map and gotchas in `skills/forecast-os/references/`.

## Capabilities

- Search live odds across Polymarket, Kalshi, and Precog; quote before buying.
- Create and fund a market to obtain real info when none is available.
- Fund Precog launchpad (upcoming) markets; claim investment and incentive rewards after deploy.
- Manage positions: list, sell, claim (Kalshi settlements are automatic).
- Safety: quote/preview first, `--confirm` only after approval, secrets via env vars or key files, never invented keys.