Skip to content

fix(bundle): make root computer-use runnable (include foundation), matching sibling bundles #2

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
Diego Colombo (colombod) wants to merge 1 commit into from
Closed

fix(bundle): make root computer-use runnable (include foundation), matching sibling bundles #2

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
31 changes: 22 additions & 9 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -37,27 +37,40 @@ CLI, no browser extension required.

## Install

Registering this bundle is ordinary Amplifier bundle management:
Use it as-is by registering this repo's **root bundle** — a normal, runnable bundle
that pulls in foundation plus the computer-use behavior — then running it:

```bash
# 1. Register it (the name "computer-use" comes from this repo's own bundle.md)
amplifier bundle add git+https://github.com/microsoft/amplifier-bundle-computer-use@main#subdirectory=behaviors/computer-use.yaml --app

# 2. Use it for a session
# Registers under the name "computer-use" (from the root bundle.md).
amplifier bundle add git+https://github.com/microsoft/amplifier-bundle-computer-use@main
amplifier run --bundle computer-use "What's on my screen right now?"

```

Confirm it registered correctly with `amplifier bundle show computer-use` — it should
list `tool-computer-use`, `hook-computer-use`, and `computer-use:computer-operator`.
Working from a local clone instead of GitHub? `amplifier bundle add
file:///path/to/amplifier-bundle-computer-use` instead.
Working from a local clone instead of GitHub? `amplifier bundle add file:///path/to/amplifier-bundle-computer-use` instead.

Adding computer-use to a bundle you already have? Include the **behavior** in that
bundle's `includes:` list — this composes its tool, hook, and agent into your
sessions:

```yaml
includes:
- bundle: foundation
- bundle: git+https://github.com/microsoft/amplifier-bundle-computer-use@main#subdirectory=behaviors/computer-use.yaml
```

You can also layer that behavior across *every* session with
`amplifier bundle add …#subdirectory=behaviors/computer-use.yaml --app`. It registers
under its behavior name, `computer-use-behavior`, following the ecosystem convention
that behaviors carry a `-behavior` suffix; run it with a plain `amplifier run "…"`
(the behavior is layered into your normal session — there is no standalone
`computer-use-behavior` bundle to target with `--bundle`).

**Registering the bundle is not the same as the tools working.** See
**[docs/SETUP.md](docs/SETUP.md)** for the four things that decide whether `computer` and
`desktop` actually function once a session starts: upstream module versions, a model with
native computer-use support, a reachable target machine, and (for remote targets) SSH.

---

## What makes this the native thing
Expand Down
1 change: 1 addition & 0 deletions bundle.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,7 @@ bundle:
description: See and control a real desktop - Windows, macOS, or Linux, local or across your network - with the LLM's native computer-use tool

includes:
- bundle: git+https://github.com/microsoft/amplifier-foundation@main
- bundle: computer-use:behaviors/computer-use
---

Expand Down