Metadata-Version: 2.4
Name: navcli
Version: 0.4.0
Summary: 可交互、可探索的浏览器命令行工具，专为 AI Agent 设计
Author: NavCLI Team
License: MIT
Project-URL: Homepage, https://github.com/navcli/navcli
Project-URL: Repository, https://github.com/navcli/navcli
Project-URL: Issues, https://github.com/navcli/navcli/issues
Keywords: browser,cli,automation,ai-agent,playwright
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: playwright>=1.40.0
Requires-Dist: cmd2>=2.4.0
Requires-Dist: fastapi>=0.109.0
Requires-Dist: uvicorn<1.0.0,>=0.25.0
Requires-Dist: pydantic>=2.5.0
Requires-Dist: cssify>=1.0.0
Requires-Dist: aiohttp>=3.9.0
Provides-Extra: dev
Requires-Dist: pytest>=7.4.0; extra == "dev"
Requires-Dist: pytest-cov>=4.1.0; extra == "dev"
Requires-Dist: ruff>=0.1.0; extra == "dev"
Requires-Dist: mypy>=1.8.0; extra == "dev"

# NavCLI - Goals & Vision

## Core Goal

**Enable AI Agents to browse the web like humans.**

Existing solutions (HTTP APIs, headless browser scripts, Playwright MCP) have limitations:
- No support for JS-rendered SPAs
- No session persistence
- Lack of interactive exploration

NavCLI's positioning: **An interactive, explorable browser CLI**

## Core Value

| Feature | What NavCLI Solves |
|---------|-------------------|
| JS Rendering | Full SPA support |
| Session Persistence | Cookies, session maintained |
| Interactive CLI | Agent can explore while operating |
| Token Optimization | Lightweight elements + on-demand text/html |

## Typical Workflow

```bash
> g https://example.com          # Navigate
> elements                       # Observe interactive elements
> c .btn-login                   # Click login
> t #email "test@example.com"    # Type email
> t #password "123456"           # Type password
> c button[type="submit"]       # Submit
> text                           # Confirm result
```

Agent can: **Navigate → Observe → Interact → Feedback → Continue**

## Vision

Become the **standard browser interaction layer** for AI Agents, enabling any Agent to control browsers via command-line interface:
- Form filling, login authentication
- Information scraping, content exploration
- Complex multi-step business processes

## Related Documentation

- [Skill File Download](https://github.com/wumu2013/navcli/blob/main/docs/skill.md)
- [Project Homepage](https://make.datavoid.fun/navcli/)
- [PRD Product Requirements](./NAVCLI_PRD.md)
