Metadata-Version: 2.4
Name: fgeo
Version: 0.1.0
Summary: fgeo — Generative Engine Optimization CLI. AI-powered content asset management and multi-platform distribution.
Author: MarvinTalk
License-Expression: MIT
Keywords: geo,seo,ai,content,cli,agent
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: typer>=0.12.0
Requires-Dist: rich>=13.0.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: pyyaml>=6.0
Requires-Dist: atproto>=0.0.54
Provides-Extra: test
Requires-Dist: pytest>=7.0; extra == "test"
Requires-Dist: pytest-cov>=5.0; extra == "test"
Provides-Extra: dev
Requires-Dist: ruff; extra == "dev"
Requires-Dist: pytest>=7.0; extra == "dev"
Requires-Dist: pytest-cov>=5.0; extra == "dev"
Requires-Dist: build; extra == "dev"
Requires-Dist: mkdocs-material; extra == "dev"
Requires-Dist: mkdocs-mermaid-zoom; extra == "dev"
Provides-Extra: ai
Requires-Dist: litellm>=1.0.0; extra == "ai"
Provides-Extra: publish
Requires-Dist: playwright>=1.40.0; extra == "publish"
Requires-Dist: httpx>=0.27.0; extra == "publish"
Dynamic: license-file

# fgeo

Generative Engine Optimization CLI for AI-assisted go-to-market work.

fgeo helps product builders turn product knowledge into a managed content system:
projects, goals, plans, platforms, content assets, and publishing tasks all live in
one local registry.

## Quick Start

```bash
pip install fgeo

fgeo init
fgeo enable copilot

fgeo project create fcontext --desc "AI context manager"
fgeo goal add fcontext "Help developers understand fcontext"
fgeo platform add fcontext devto --directions "tutorial,architecture" --pace "2/month"
fgeo plan create fcontext cold-start --strategy "Developer community launch"
fgeo plan assign fcontext cold-start devto --direction tutorial --target 3

fgeo content register docs/first-post.md \
  --project fcontext \
  --platform devto \
  --plan cold-start \
  --direction tutorial \
  --type article \
  --status draft

fgeo status fcontext
```

## What fgeo Manages

```text
Project -> Goal -> Plan -> Platform -> Content -> Publish Task
```

- Project: a product, personal IP, or campaign target.
- Goal: what success looks like.
- Plan: the go-to-market strategy and target counts.
- Platform: a distribution channel with its own directions and cadence.
- Content: one platform-native content asset.
- Publish task: the handoff between draft content and live distribution.

## Supported Agent Integrations

`fgeo enable <agent>` writes fgeo instructions into each agent's native location
and also enables fcontext for the same workspace.

Supported agents:

`copilot`, `claude`, `cursor`, `trae`, `qwen`, `kiro`, `opencode`,
`openclaw`, `zed`, `pi`, `antigravity`, and `codex`.

## Documentation

The full documentation site is built with MkDocs:

```bash
pip install -e ".[dev]"
mkdocs serve
```

Docs source lives in `docs/`.

