Metadata-Version: 2.4
Name: linkworld
Version: 0.8.0
Summary: Linkworld CLI — develop and deploy apps to the Linkworld Open App Platform. 0.8.0: linkworld init now scaffolds with lw-ui (.lw-card, .lw-tab, .lw-btn, …) by default + linkworld lint warns when web/ doesn't use lw-ui.
Project-URL: Homepage, https://linkworld.ai
Project-URL: Documentation, https://linkworld.ai/docs/cli
Project-URL: Source, https://github.com/linkworld/linkworld
Author-email: Linkworld <hello@linkworld.ai>
License: MIT
Keywords: agents,ai,cli,linkworld,platform
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.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Build Tools
Requires-Python: >=3.10
Requires-Dist: click>=8.1
Requires-Dist: httpx>=0.27
Requires-Dist: linkworld-sdk>=0.5.0
Requires-Dist: pyyaml>=6.0
Requires-Dist: rich>=13.7
Provides-Extra: dev
Requires-Dist: pytest-asyncio>=0.24; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Description-Content-Type: text/markdown

# linkworld CLI

Develop and deploy apps to the
[Linkworld](https://linkworld.ai) Open App Platform.

> **Status: 0.x alpha.** Phase 2 of the open-platform rollout. The CLI
> wraps a Python SDK and the platform's `/api/dev/*` endpoints.

## Install

```bash
pip install linkworld
```

## Quickstart

```bash
# 1. Get a dev session token from a Linkworld admin (M11 will replace
#    this step with GitHub OAuth device flow).
linkworld login --token <jwt>

# 2. Scaffold a new app
linkworld init my-tax-bot --github-owner my-github-username
cd my-tax-bot

# 3. Edit linkworld.app.yaml + main.py to taste
#    Run locally:
pip install -r requirements.txt
LINKWORLD_LOCAL=1 python main.py

# 4. Deploy. Either tag and let CI handle it:
git tag v0.1.0 && git push --tags

# Or push and register manually:
docker build -t ghcr.io/my-github-username/my-tax-bot:0.1.0 .
docker push ghcr.io/my-github-username/my-tax-bot:0.1.0
linkworld deploy --skip-build
```

## Commands

| | |
|---|---|
| `linkworld login --token <jwt>` | Save credentials to `~/.linkworld/config.toml` |
| `linkworld whoami` | Show the logged-in dev account |
| `linkworld logout` | Discard credentials |
| `linkworld init <slug>` | Scaffold a new app project |
| `linkworld deploy` | Build + push image, register version with platform |
| `linkworld apps list` | List your apps |
| `linkworld apps show <slug>` | App details + version history |
| `linkworld secrets ...` | Manage app-scoped secrets (coming with M7) |

## Configuration

`~/.linkworld/config.toml`:

```toml
[platform]
api_url = "https://api.linkworld.ai"

[auth]
token = "<jwt>"
```

Override via environment:

- `LINKWORLD_API_URL` — platform endpoint (default `https://api.linkworld.ai`)
- `LINKWORLD_TOKEN` — overrides the token in the config file (useful in CI)

## License

MIT.
