Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
34 changes: 30 additions & 4 deletions .cursor/commands/qa.md
Original file line number Diff line number Diff line change
Expand Up @@ -57,12 +57,14 @@ Here are all valid language + template combinations:
| typescript | magnitude | ts-magnitude | ts-magnitude | Yes | ANTHROPIC_API_KEY |
| typescript | openai-computer-use | ts-openai-cua | ts-openai-cua | Yes | OPENAI_API_KEY |
| typescript | gemini-computer-use | ts-gemini-cua | ts-gemini-cua | Yes | GOOGLE_API_KEY |
| typescript | claude-agent-sdk | ts-claude-agent-sdk | ts-claude-agent-sdk | Yes | ANTHROPIC_API_KEY |
| python | sample-app | py-sample-app | python-basic | No | - |
| python | captcha-solver | py-captcha-solver | python-captcha-solver | No | - |
| python | browser-use | py-browser-use | python-bu | Yes | OPENAI_API_KEY |
| python | anthropic-computer-use | py-anthropic-cua | python-anthropic-cua | Yes | ANTHROPIC_API_KEY |
| python | openai-computer-use | py-openai-cua | python-openai-cua | Yes | OPENAI_API_KEY |
| python | openagi-computer-use | py-openagi-cua | python-openagi-cua | Yes | OAGI_API_KEY |
| python | claude-agent-sdk | py-claude-agent-sdk | py-claude-agent-sdk | Yes | ANTHROPIC_API_KEY |

### Create Commands

Expand All @@ -77,6 +79,7 @@ Run each of these (they are non-interactive when all flags are provided):
../bin/kernel create -n ts-magnitude -l typescript -t magnitude
../bin/kernel create -n ts-openai-cua -l typescript -t openai-computer-use
../bin/kernel create -n ts-gemini-cua -l typescript -t gemini-computer-use
../bin/kernel create -n ts-claude-agent-sdk -l typescript -t claude-agent-sdk

# Python templates
../bin/kernel create -n py-sample-app -l python -t sample-app
Expand All @@ -85,6 +88,7 @@ Run each of these (they are non-interactive when all flags are provided):
../bin/kernel create -n py-anthropic-cua -l python -t anthropic-computer-use
../bin/kernel create -n py-openai-cua -l python -t openai-computer-use
../bin/kernel create -n py-openagi-cua -l python -t openagi-computer-use
../bin/kernel create -n py-claude-agent-sdk -l python -t claude-agent-sdk
```

## Step 5: Deploy Each Template
Expand Down Expand Up @@ -163,6 +167,15 @@ echo "GOOGLE_API_KEY=<value from human>" > .env
cd ..
```

**ts-claude-agent-sdk** (needs ANTHROPIC_API_KEY):

```bash
cd ts-claude-agent-sdk
echo "ANTHROPIC_API_KEY=<value from human>" > .env
../bin/kernel deploy index.ts --env-file .env
cd ..
```

**py-browser-use** (needs OPENAI_API_KEY):

```bash
Expand Down Expand Up @@ -199,6 +212,15 @@ echo "OAGI_API_KEY=<value from human>" > .env
cd ..
```

**py-claude-agent-sdk** (needs ANTHROPIC_API_KEY):

```bash
cd py-claude-agent-sdk
echo "ANTHROPIC_API_KEY=<value from human>" > .env
../bin/kernel deploy main.py --env-file .env
cd ..
```

## Step 6: Provide Invoke Commands

Once all deployments are complete, present the human with these invoke commands to test manually:
Expand All @@ -212,6 +234,7 @@ kernel invoke ts-anthropic-cua cua-task --payload '{"query": "Return the first u
kernel invoke ts-magnitude mag-url-extract --payload '{"url": "https://en.wikipedia.org/wiki/Special:Random"}'
kernel invoke ts-openai-cua cua-task --payload '{"task": "Go to https://news.ycombinator.com and get the top 5 articles"}'
kernel invoke ts-gemini-cua gemini-cua-task --payload '{"startingUrl": "https://www.magnitasks.com/", "instruction": "Click the Tasks option in the left-side bar, and move the 5 items in the To Do and In Progress items to the Done section of the Kanban board? You are done successfully when the items are moved."}'
kernel invoke ts-claude-agent-sdk agent-task --payload '{"task": "Go to https://news.ycombinator.com and get the top 3 stories"}'

# Python apps
kernel invoke python-basic get-page-title --payload '{"url": "https://www.google.com"}'
Expand All @@ -220,13 +243,14 @@ kernel invoke python-bu bu-task --payload '{"task": "Compare the price of gpt-4o
kernel invoke python-anthropic-cua cua-task --payload '{"query": "Return the first url of a search result for NYC restaurant reviews Pete Wells"}'
kernel invoke python-openai-cua cua-task --payload '{"task": "Go to https://news.ycombinator.com and get the top 5 articles"}'
kernel invoke python-openagi-cua openagi-default-task -p '{"instruction": "Navigate to https://agiopen.org and click the What is Computer Use? button"}'
kernel invoke py-claude-agent-sdk agent-task --payload '{"task": "Go to https://news.ycombinator.com and get the top 3 stories"}'
```

## Step 7: Automated Runtime Testing (Optional)

**STOP and ask the human:** "Would you like me to automatically invoke all 13 templates and report back on their runtime status?"
**STOP and ask the human:** "Would you like me to automatically invoke all 15 templates and report back on their runtime status?"

If the human agrees, invoke each template and collect results. Present findings in this format:
If the human agrees, invoke each template use the Kernel CLI and collect results. Present findings in this format:

### Testing Guidelines
- **Parallel execution:** You may run multiple invocations in parallel to speed up testing.
Expand All @@ -243,12 +267,14 @@ If the human agrees, invoke each template and collect results. Present findings
| ts-magnitude | ts-magnitude | | |
| ts-openai-cua | ts-openai-cua | | |
| ts-gemini-cua | ts-gemini-cua | | |
| ts-claude-agent-sdk | ts-claude-agent-sdk | | |
| py-sample-app | python-basic | | |
| py-captcha-solver | python-captcha-solver | | |
| py-browser-use | python-bu | | |
| py-anthropic-cua | python-anthropic-cua | | |
| py-openai-cua | python-openai-cua | | |
| py-openagi-cua | python-openagi-cua | | |
| py-claude-agent-sdk | py-claude-agent-sdk | | |

Status values:
- **SUCCESS**: App started and returned a result
Expand All @@ -261,9 +287,9 @@ Notes should include brief error messages for failures or confirmation of succes
- [ ] Built CLI with `make build`
- [ ] Created QA directory
- [ ] Got KERNEL_API_KEY from human
- [ ] Created all 13 template variations
- [ ] Created all 15 template variations
- [ ] Got required API keys from human (OPENAI_API_KEY, ANTHROPIC_API_KEY, GOOGLE_API_KEY, OAGI_API_KEY)
- [ ] Deployed all 13 apps
- [ ] Deployed all 15 apps
- [ ] Provided invoke commands to human for manual testing
- [ ] (Optional) Ran automated runtime testing and reviewed results

Expand Down
16 changes: 8 additions & 8 deletions .goreleaser.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -29,23 +29,23 @@ archives:
brews:
- name: kernel
repository:
owner: onkernel
owner: kernel
name: homebrew-tap
branch: main
directory: Formula
description: "Kernel CLI"
homepage: "https://github.com/onkernel/cli"
homepage: "https://github.com/kernel/cli"
test: |
system "#{bin}/kernel", "--version"

npms:
- name: "@onkernel/cli"
repository: "https://github.com/onkernel"
bugs: https://github.com/onkernel/cli/issues
repository: "https://github.com/kernel"
bugs: https://github.com/kernel/cli/issues
description: Kernel CLI
homepage: https://onkernel.com/docs
homepage: https://www.kernel.sh/docs
license: MIT
author: "Rafael Garcia <raf@onkernel.com>"
author: "Rafael Garcia <raf@kernel.sh>"
access: public
keywords:
- kernel
Expand Down Expand Up @@ -85,11 +85,11 @@ changelog:
release:
name_template: "Kernel CLI v{{ .Version }}"
footer: |
**Full Changelog**: https://github.com/onkernel/cli/compare/{{ .PreviousTag }}...{{ .Tag }}
**Full Changelog**: https://github.com/kernel/cli/compare/{{ .PreviousTag }}...{{ .Tag }}

## What to do next?

- Read the [documentation](https://onkernel.com/docs)
- Read the [documentation](https://www.kernel.sh/docs)
- Join our [Discord server](https://discord.gg/FBrveQRcud)
- Follow us on Twitter [here](https://twitter.com/rfgarcia) and [here](https://x.com/juecd__)

Expand Down
16 changes: 10 additions & 6 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
</p>

<p align="center">
<img alt="GitHub License" src="https://img.shields.io/github/license/onkernel/cli">
<img alt="GitHub License" src="https://img.shields.io/github/license/kernel/cli">
<a href="https://discord.gg/FBrveQRcud"><img src="https://img.shields.io/discord/1342243238748225556?logo=discord&logoColor=white&color=7289DA" alt="Discord"></a>
<a href="https://x.com/juecd__"><img src="https://img.shields.io/twitter/follow/juecd__" alt="Follow @juecd__"></a>
<a href="https://x.com/rfgarcia"><img src="https://img.shields.io/twitter/follow/rfgarcia" alt="Follow @rfgarcia"></a>
Expand All @@ -13,7 +13,7 @@

The Kernel CLI is a fast, friendly command‑line interface for Kernel — the platform that provides sandboxed, ready‑to‑use Chrome browsers for browser automations and web agents.

Sign up at [onkernel.com](https://www.onkernel.com/) and read the [docs](https://onkernel.com/docs/introduction).
Sign up at [kernel.sh](https://www.kernel.sh/) and read the [docs](https://www.kernel.sh/docs/introduction).

## What's Kernel?

Expand Down Expand Up @@ -124,6 +124,7 @@ Create an API key from the [Kernel dashboard](https://dashboard.onkernel.com).
- `gemini-computer-use` - Implements a Gemini computer use agent (TypeScript only)
- `openagi-computer-use` - OpenAGI Lux computer-use models (Python only)
- `magnitude` - Magnitude framework sample (TypeScript only)
- `claude-agent-sdk` - Claude Agent SDK browser automation agent

### App Deployment

Expand Down Expand Up @@ -395,6 +396,9 @@ kernel create --name my-agent --language ts --template stagehand

# Create a Python Computer Use app
kernel create --name my-cu-app --language py --template anthropic-computer-use

# Create a Claude Agent SDK app (TypeScript or Python)
kernel create --name my-claude-agent --language ts --template claude-agent-sdk
```

### Deploy with environment variables
Expand Down Expand Up @@ -587,15 +591,15 @@ kernel proxies delete prx_123 --yes

For complete documentation, visit:

- [📖 Documentation](https://onkernel.com/docs)
- [🚀 Quickstart Guide](https://onkernel.com/docs/quickstart)
- [📋 CLI Reference](https://onkernel.com/docs/reference/cli)
- [📖 Documentation](https://www.kernel.sh/docs)
- [🚀 Quickstart Guide](https://www.kernel.sh/docs/quickstart)
- [📋 CLI Reference](https://www.kernel.sh/docs/reference/cli)

## Support

- [Discord Community](https://discord.gg/kernel)
- [GitHub Issues](https://github.com/onkernel/kernel/issues)
- [Documentation](https://onkernel.com/docs)
- [Documentation](https://www.kernel.sh/docs)

---

Expand Down
2 changes: 1 addition & 1 deletion cmd/app.go
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ import (
"fmt"
"strings"

"github.com/onkernel/cli/pkg/util"
"github.com/kernel/cli/pkg/util"
"github.com/onkernel/kernel-go-sdk"
"github.com/pterm/pterm"
"github.com/samber/lo"
Expand Down
2 changes: 1 addition & 1 deletion cmd/auth.go
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ import (
"time"

"github.com/golang-jwt/jwt/v5"
"github.com/onkernel/cli/pkg/auth"
"github.com/kernel/cli/pkg/auth"
"github.com/pterm/pterm"
"github.com/spf13/cobra"
"github.com/zalando/go-keyring"
Expand Down
2 changes: 1 addition & 1 deletion cmd/browser_pools.go
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ import (
"fmt"
"strings"

"github.com/onkernel/cli/pkg/util"
"github.com/kernel/cli/pkg/util"
"github.com/onkernel/kernel-go-sdk"
"github.com/onkernel/kernel-go-sdk/option"
"github.com/pterm/pterm"
Expand Down
2 changes: 1 addition & 1 deletion cmd/browsers.go
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ import (
"strconv"
"strings"

"github.com/onkernel/cli/pkg/util"
"github.com/kernel/cli/pkg/util"
"github.com/onkernel/kernel-go-sdk"
"github.com/onkernel/kernel-go-sdk/option"
"github.com/onkernel/kernel-go-sdk/packages/pagination"
Expand Down
2 changes: 1 addition & 1 deletion cmd/create.go
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ import (
"os"
"path/filepath"

"github.com/onkernel/cli/pkg/create"
"github.com/kernel/cli/pkg/create"
"github.com/pterm/pterm"
"github.com/spf13/cobra"
)
Expand Down
2 changes: 1 addition & 1 deletion cmd/create_test.go
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ import (
"path/filepath"
"testing"

"github.com/onkernel/cli/pkg/create"
"github.com/kernel/cli/pkg/create"
"github.com/pterm/pterm"
"github.com/stretchr/testify/assert"
"github.com/stretchr/testify/require"
Expand Down
2 changes: 1 addition & 1 deletion cmd/deploy.go
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ import (
"time"

"github.com/joho/godotenv"
"github.com/onkernel/cli/pkg/util"
"github.com/kernel/cli/pkg/util"
kernel "github.com/onkernel/kernel-go-sdk"
"github.com/onkernel/kernel-go-sdk/option"
"github.com/pterm/pterm"
Expand Down
2 changes: 1 addition & 1 deletion cmd/extensions.go
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ import (
"path/filepath"
"time"

"github.com/onkernel/cli/pkg/util"
"github.com/kernel/cli/pkg/util"
"github.com/onkernel/kernel-go-sdk"
"github.com/onkernel/kernel-go-sdk/option"
"github.com/pterm/pterm"
Expand Down
2 changes: 1 addition & 1 deletion cmd/invoke.go
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ import (
"syscall"
"time"

"github.com/onkernel/cli/pkg/util"
"github.com/kernel/cli/pkg/util"
"github.com/onkernel/kernel-go-sdk"
"github.com/onkernel/kernel-go-sdk/option"
"github.com/pterm/pterm"
Expand Down
2 changes: 1 addition & 1 deletion cmd/kernel/main.go
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ package main
import (
"runtime"

"github.com/onkernel/cli/cmd"
"github.com/kernel/cli/cmd"
)

var (
Expand Down
2 changes: 1 addition & 1 deletion cmd/login.go
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ import (
"os/signal"
"syscall"

"github.com/onkernel/cli/pkg/auth"
"github.com/kernel/cli/pkg/auth"
"github.com/pterm/pterm"
"github.com/spf13/cobra"
)
Expand Down
2 changes: 1 addition & 1 deletion cmd/logout.go
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ package cmd
import (
"fmt"

"github.com/onkernel/cli/pkg/auth"
"github.com/kernel/cli/pkg/auth"
"github.com/pterm/pterm"
"github.com/spf13/cobra"
)
Expand Down
2 changes: 1 addition & 1 deletion cmd/logs.go
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ import (
"fmt"
"time"

"github.com/onkernel/cli/pkg/util"
"github.com/kernel/cli/pkg/util"
"github.com/onkernel/kernel-go-sdk"
"github.com/onkernel/kernel-go-sdk/option"
"github.com/pterm/pterm"
Expand Down
2 changes: 1 addition & 1 deletion cmd/mcp/server.go
Original file line number Diff line number Diff line change
Expand Up @@ -48,7 +48,7 @@ func runServer(cmd *cobra.Command, args []string) {

pterm.Println()
pterm.DefaultSection.Println("Documentation")
pterm.Println(" https://onkernel.com/docs/reference/mcp-server")
pterm.Println(" https://www.kernel.sh/docs/reference/mcp-server")

pterm.Println()
pterm.Info.Println("Use 'kernel mcp install --target <tool>' to configure your AI tool automatically.")
Expand Down
2 changes: 1 addition & 1 deletion cmd/profiles.go
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ import (
"net/http"
"os"

"github.com/onkernel/cli/pkg/util"
"github.com/kernel/cli/pkg/util"
"github.com/onkernel/kernel-go-sdk"
"github.com/onkernel/kernel-go-sdk/option"
"github.com/pterm/pterm"
Expand Down
4 changes: 2 additions & 2 deletions cmd/proxies/create.go
Original file line number Diff line number Diff line change
Expand Up @@ -4,8 +4,8 @@ import (
"context"
"fmt"

"github.com/onkernel/cli/pkg/table"
"github.com/onkernel/cli/pkg/util"
"github.com/kernel/cli/pkg/table"
"github.com/kernel/cli/pkg/util"
"github.com/onkernel/kernel-go-sdk"
"github.com/pterm/pterm"
"github.com/spf13/cobra"
Expand Down
2 changes: 1 addition & 1 deletion cmd/proxies/delete.go
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ import (
"context"
"fmt"

"github.com/onkernel/cli/pkg/util"
"github.com/kernel/cli/pkg/util"
"github.com/pterm/pterm"
"github.com/spf13/cobra"
)
Expand Down
4 changes: 2 additions & 2 deletions cmd/proxies/get.go
Original file line number Diff line number Diff line change
Expand Up @@ -4,8 +4,8 @@ import (
"context"
"fmt"

"github.com/onkernel/cli/pkg/table"
"github.com/onkernel/cli/pkg/util"
"github.com/kernel/cli/pkg/table"
"github.com/kernel/cli/pkg/util"
"github.com/onkernel/kernel-go-sdk"
"github.com/pterm/pterm"
"github.com/spf13/cobra"
Expand Down
4 changes: 2 additions & 2 deletions cmd/proxies/list.go
Original file line number Diff line number Diff line change
Expand Up @@ -5,8 +5,8 @@ import (
"fmt"
"strings"

"github.com/onkernel/cli/pkg/table"
"github.com/onkernel/cli/pkg/util"
"github.com/kernel/cli/pkg/table"
"github.com/kernel/cli/pkg/util"
"github.com/onkernel/kernel-go-sdk"
"github.com/pterm/pterm"
"github.com/spf13/cobra"
Expand Down
Loading