HHostingByteSoftware
Ctrl K
ComunidadGuías…

README.md

Rama master · réplica de lectura del repositorio original.

Archivo original ↗Preguntar a KiBot
<p align="center">
  <picture>
    <source media="(prefers-color-scheme: dark)" srcset="docs/assets/wish-logo-dark.svg">
    <img src="docs/assets/wish-logo-light.svg" alt="Wish" width="300">
  </picture>
</p>

<p align="center">
  <strong>A minimal yet ready-to-use AI agent harness, built on best practices for frontier models.</strong>
</p>

<p align="center">
  <a href="https://github.com/WindustH/wish-core">Wish server</a> ·
  <a href="docs/en/README.md">Documentation</a> ·
  <a href="README.zh-CN.md">简体中文</a>
</p>

---

Wish Web is the client for [Wish](https://github.com/WindustH/wish-core): one
app for a large monitor and a phone.

<p align="center">
  <img src="docs/assets/screenshot-desktop.png" alt="Wish on the desktop" width="74%">
  &nbsp;
  <img src="docs/assets/screenshot-mobile.png" alt="Wish on a phone" width="22%">
</p>

## Features

- **See the work as it happens.** Replies, reasoning, command output and file
  changes stream in, folded so long tasks stay readable.
- **Keep talking while it works.** Queue, reorder or cancel follow-ups,
  interrupt at any time, and answer the agent's questions right in the
  conversation.
- **Desktop and phone.** A layout for each, installable as an app, in light and
  dark, English and Chinese.
- **Set up in a minute.** A first-run guide with provider presets, and settings
  that apply without restarting the server.

## Quick start

Wish's packages (`wish-agent` on npm, the AUR and Homebrew) already include
this app: install one and open <http://127.0.0.1:8790>, as the
[Wish quick start](https://github.com/WindustH/wish-core#quick-start) shows.

To develop the app, or to serve it apart from Wish, build it yourself. You
need [Node.js](https://nodejs.org) 22.19 or newer and a running Wish server.

```sh
git clone https://github.com/WindustH/wish-web.git
cd wish-web
./pnpmw install --frozen-lockfile
./pnpmw build
node serve.ts
```

`./pnpmw` runs the pinned pnpm through Corepack, so no global install is
needed. The server is configured with environment variables:

| Variable | Default | Purpose |
| --- | --- | --- |
| `WISH_UPSTREAM` | `http://127.0.0.1:9780` | Address of the Wish server |
| `WISH_HTTP_TOKEN` | | Wish's access token, added to every API request on the server side |
| `PORT` | `8790` | Port to listen on |
| `LISTEN_HOST` | `127.0.0.1` | Address to listen on; `0.0.0.0` for your local network |
| `ALLOWED_HOSTS` | | Extra `host:port` names the app may be opened under, comma-separated |

To use Wish from your phone or install it as an app, serve it over HTTPS as
described in the [deployment guide](docs/en/deployment.md).

## Documentation

- [User guide](docs/en/user-guide.md): everything you can do in the app,
  including keyboard shortcuts.
- [Configuration](docs/en/configuration.md): the settings screens and what
  they change.
- [Deployment](docs/en/deployment.md): serving on your network, HTTPS, running
  as a service and upgrading.
- [Troubleshooting](docs/en/troubleshooting.md)
- [Development](docs/en/development.md) and [architecture](docs/en/architecture.md)
  for contributors.

## Development

```sh
./pnpmw install --frozen-lockfile
WISH_UPSTREAM=http://127.0.0.1:9780 ./pnpmw dev   # http://127.0.0.1:5173
./pnpmw typecheck
./pnpmw test
```

Built with Vue 3, TypeScript and Vite. See the
[development guide](docs/en/development.md) for the project layout and
conventions. Contributions are welcome.

## License

[MIT](LICENSE). Bundled fonts and libraries keep their own licenses, listed in
[THIRD_PARTY.md](THIRD_PARTY.md).