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
19 changes: 19 additions & 0 deletions .github/workflows/lint.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
name: Format and lint

on:
pull_request:
push:
branches: [main]

jobs:
check:
runs-on: ubuntu-latest
timeout-minutes: 10
steps:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
with:
node-version: 22
- run: npm ci
- run: npm run format:check
- run: npm run lint
5 changes: 5 additions & 0 deletions .oxfmtrc.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
{
"$schema": "./node_modules/oxfmt/configuration_schema.json",
"printWidth": 160,
"ignorePatterns": ["**/package-lock.json"]
}
305 changes: 305 additions & 0 deletions .oxlintrc.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,305 @@
{
"$schema": "./node_modules/oxlint/configuration_schema.json",
"categories": {
"correctness": "error",
"suspicious": "error"
},
"rules": {
"no-underscore-dangle": [
"error",
{
"allow": ["_pty"]
}
],
"no-restricted-imports": [
"error",
{
"paths": [
{
"name": "node:child_process",
"message": "Start programs through this plugin's server/system.ts, which runs them from a folder the repo can't control."
},
{
"name": "child_process",
"message": "Start programs through this plugin's server/system.ts, which runs them from a folder the repo can't control."
},
{
"name": "node:fs",
"importNames": [
"appendFile",
"appendFileSync",
"chmod",
"chmodSync",
"chown",
"chownSync",
"copyFile",
"copyFileSync",
"cp",
"cpSync",
"createWriteStream",
"default",
"fchmod",
"fchmodSync",
"fchown",
"fchownSync",
"ftruncate",
"ftruncateSync",
"futimes",
"futimesSync",
"lchmod",
"lchmodSync",
"lchown",
"lchownSync",
"link",
"linkSync",
"lutimes",
"lutimesSync",
"mkdir",
"mkdirSync",
"mkdtemp",
"mkdtempSync",
"open",
"openSync",
"promises",
"rename",
"renameSync",
"rm",
"rmSync",
"rmdir",
"rmdirSync",
"symlink",
"symlinkSync",
"truncate",
"truncateSync",
"unlink",
"unlinkSync",
"utimes",
"utimesSync",
"write",
"writeFile",
"writeFileSync",
"writeSync",
"writev",
"writevSync"
],
"message": "Change files through this plugin's server/system.ts, which keeps each change inside a folder the caller names and off links."
},
{
"name": "fs",
"importNames": [
"appendFile",
"appendFileSync",
"chmod",
"chmodSync",
"chown",
"chownSync",
"copyFile",
"copyFileSync",
"cp",
"cpSync",
"createWriteStream",
"default",
"fchmod",
"fchmodSync",
"fchown",
"fchownSync",
"ftruncate",
"ftruncateSync",
"futimes",
"futimesSync",
"lchmod",
"lchmodSync",
"lchown",
"lchownSync",
"link",
"linkSync",
"lutimes",
"lutimesSync",
"mkdir",
"mkdirSync",
"mkdtemp",
"mkdtempSync",
"open",
"openSync",
"promises",
"rename",
"renameSync",
"rm",
"rmSync",
"rmdir",
"rmdirSync",
"symlink",
"symlinkSync",
"truncate",
"truncateSync",
"unlink",
"unlinkSync",
"utimes",
"utimesSync",
"write",
"writeFile",
"writeFileSync",
"writeSync",
"writev",
"writevSync"
],
"message": "Change files through this plugin's server/system.ts, which keeps each change inside a folder the caller names and off links."
},
{
"name": "node:fs/promises",
"importNames": [
"appendFile",
"chmod",
"chown",
"copyFile",
"cp",
"default",
"fchmod",
"fchown",
"ftruncate",
"futimes",
"lchmod",
"lchown",
"link",
"lutimes",
"mkdir",
"mkdtemp",
"open",
"rename",
"rm",
"rmdir",
"symlink",
"truncate",
"unlink",
"utimes",
"write",
"writeFile",
"writev"
],
"message": "Change files through this plugin's server/system.ts, which keeps each change inside a folder the caller names and off links."
},
{
"name": "fs/promises",
"importNames": [
"appendFile",
"chmod",
"chown",
"copyFile",
"cp",
"default",
"fchmod",
"fchown",
"ftruncate",
"futimes",
"lchmod",
"lchown",
"link",
"lutimes",
"mkdir",
"mkdtemp",
"open",
"rename",
"rm",
"rmdir",
"symlink",
"truncate",
"unlink",
"utimes",
"write",
"writeFile",
"writev"
],
"message": "Change files through this plugin's server/system.ts, which keeps each change inside a folder the caller names and off links."
},
{
"name": "node:module",
"importNames": ["createRequire", "default"],
"message": "require() loads modules this lint can't see."
},
{
"name": "module",
"importNames": ["createRequire", "default"],
"message": "require() loads modules this lint can't see."
}
]
}
],
"no-restricted-globals": [
"error",
{
"name": "require",
"message": "require() loads modules the import rule can't see."
}
],
"no-restricted-properties": [
"error",
{
"object": "process",
"property": "binding",
"message": "Loads Node internals this lint can't see."
},
{
"object": "process",
"property": "getBuiltinModule",
"message": "Loads node:fs or node:child_process past the import rule. Use this plugin's server/system.ts."
}
]
},
"overrides": [
{
"files": [
"shell-yeah/shared/keys.ts",
"shell-yeah/server/claude.ts",
"shell-yeah/server/screen.ts",
"playwright-pulse/server/attachments.ts",
"progress/shared/markdown.ts"
],
"rules": {
"no-control-regex": "off"
}
},
{
"files": ["*/index.client.tsx", "*/client/**", "*/shared/**"],
"rules": {
"unicorn/no-array-sort": "off",
"unicorn/no-array-reverse": "off",
"no-restricted-properties": [
"error",
{
"property": "toSorted",
"message": "Hermes, which runs Paseo on phones, has no Array#toSorted. Copy the array, then sort it."
},
{
"property": "toReversed",
"message": "Not every Hermes build Paseo ships on has Array#toReversed. Copy the array, then reverse it."
},
{
"object": "process",
"property": "binding",
"message": "Loads Node internals this lint can't see."
},
{
"object": "process",
"property": "getBuiltinModule",
"message": "Loads node:fs or node:child_process past the import rule. Use this plugin's server/system.ts."
}
]
}
},
{
"files": [
"**/*.test.ts",
"*/server/system.ts",
"shell-yeah/server/proc.ts",
"playwright-pulse/server/pulse-reporter.mjs",
"scripts/**",
"*/scripts/**",
"test-support/**"
],
"rules": {
"no-restricted-imports": "off",
"no-restricted-globals": "off"
}
}
]
}
16 changes: 8 additions & 8 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,10 +28,10 @@ npm run dev

To see which copy Paseo is using, run `paseo plugin ls`. If `paseo` isn't on your `PATH`, use `/Applications/Paseo.app/Contents/Resources/bin/paseo`. `npm run dev` finds it either way.

| Problem | Fix |
| --- | --- |
| Problem | Fix |
| ---------------------------------------------------- | ------------------------------------------------------------------------------ |
| `npm run typecheck failed` in a copy you didn't edit | Its dependencies are out of date. Run `npm install`, then `npm run dev` again. |
| Checks pass but the plugin isn't `running` | Run `paseo plugin logs <plugin>` to see why it didn't start. |
| Checks pass but the plugin isn't `running` | Run `paseo plugin logs <plugin>` to see why it didn't start. |

Switching copies keeps what a plugin saved in `~/.paseo/plugin-data/`.

Expand All @@ -41,11 +41,11 @@ Each plugin versions itself in that directory's `package.json`. npm and the Pase

Versions follow [semver](https://semver.org). Each plugin moves from 0.x to `1.0.0` at its next release. From then on:

| The change | Bump | Example |
| --- | --- | --- |
| Breaks something for people already using the plugin: removes a feature or setting, moves saved data | First number | `1.4.2` to `2.0.0` |
| Adds a feature, or raises the minimum Paseo version | Middle number | `1.4.2` to `1.5.0` |
| Fixes a bug, or changes only the README or store page | Last number | `1.4.2` to `1.4.3` |
| The change | Bump | Example |
| ---------------------------------------------------------------------------------------------------- | ------------- | ------------------ |
| Breaks something for people already using the plugin: removes a feature or setting, moves saved data | First number | `1.4.2` to `2.0.0` |
| Adds a feature, or raises the minimum Paseo version | Middle number | `1.4.2` to `1.5.0` |
| Fixes a bug, or changes only the README or store page | Last number | `1.4.2` to `1.4.3` |

A raised minimum Paseo version breaks nothing for current users. A Paseo older than the new `requirements.paseo` refuses the update and keeps the installed version running.

Expand Down
18 changes: 9 additions & 9 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,15 +2,15 @@

Plugins for [Paseo](https://paseo.sh). Each plugin lives in its own directory and can be installed independently.

| Plugin | What it adds |
| --- | --- |
| <img src="https://raw.githubusercontent.com/stevecastaneda/paseo-plugins/main/time-since/icon.png" alt="" width="24" height="24" align="center"> [time-since](time-since/README.md) | Elapsed time since the last chat message, shown above the composer. |
| <img src="https://raw.githubusercontent.com/stevecastaneda/paseo-plugins/main/setup-monitor/icon.png" alt="" width="24" height="24" align="center"> [setup-monitor](setup-monitor/README.md) | Live worktree setup progress and logs from a top-bar button. |
| <img src="https://raw.githubusercontent.com/stevecastaneda/paseo-plugins/main/workspace-links/icon.png" alt="" width="24" height="24" align="center"> [workspace-links](workspace-links/README.md) | Quick access to workspace URLs from a JSON file. |
| <img src="https://raw.githubusercontent.com/stevecastaneda/paseo-plugins/main/history/icon.png" alt="" width="24" height="24" align="center"> [history](history/README.md) | Inspect chat messages, tools, and raw session records from a composer pill. |
| <img src="https://raw.githubusercontent.com/stevecastaneda/paseo-plugins/main/progress/icon.png" alt="" width="24" height="24" align="center"> [progress](progress/README.md) | A live progress dashboard per worktree, drawn from a file agents write with the Progress tools on Paseo 0.14 and later, or the `paseo-progress` command. |
| <img src="https://raw.githubusercontent.com/stevecastaneda/paseo-plugins/main/playwright-pulse/icon.png" alt="" width="24" height="24" align="center"> [playwright-pulse](playwright-pulse/README.md) | A live dashboard for a worktree's Playwright test run, with each failure's screenshot, video and trace. |
| <img src="https://raw.githubusercontent.com/stevecastaneda/paseo-plugins/main/shell-yeah/icon.png" alt="" width="24" height="24" align="center"> [shell-yeah](shell-yeah/README.md) | `/sh` runs a command as you, with live output in the chat that the agent sees only if you send it. Commands the agent hands you get a Run button. |
| Plugin | What it adds |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <img src="https://raw.githubusercontent.com/stevecastaneda/paseo-plugins/main/time-since/icon.png" alt="" width="24" height="24" align="center"> [time-since](time-since/README.md) | Elapsed time since the last chat message, shown above the composer. |
| <img src="https://raw.githubusercontent.com/stevecastaneda/paseo-plugins/main/setup-monitor/icon.png" alt="" width="24" height="24" align="center"> [setup-monitor](setup-monitor/README.md) | Live worktree setup progress and logs from a top-bar button. |
| <img src="https://raw.githubusercontent.com/stevecastaneda/paseo-plugins/main/workspace-links/icon.png" alt="" width="24" height="24" align="center"> [workspace-links](workspace-links/README.md) | Quick access to workspace URLs from a JSON file. |
| <img src="https://raw.githubusercontent.com/stevecastaneda/paseo-plugins/main/history/icon.png" alt="" width="24" height="24" align="center"> [history](history/README.md) | Inspect chat messages, tools, and raw session records from a composer pill. |
| <img src="https://raw.githubusercontent.com/stevecastaneda/paseo-plugins/main/progress/icon.png" alt="" width="24" height="24" align="center"> [progress](progress/README.md) | A live progress dashboard per worktree, drawn from a file agents write with the Progress tools on Paseo 0.14 and later, or the `paseo-progress` command. |
| <img src="https://raw.githubusercontent.com/stevecastaneda/paseo-plugins/main/playwright-pulse/icon.png" alt="" width="24" height="24" align="center"> [playwright-pulse](playwright-pulse/README.md) | A live dashboard for a worktree's Playwright test run, with each failure's screenshot, video and trace. |
| <img src="https://raw.githubusercontent.com/stevecastaneda/paseo-plugins/main/shell-yeah/icon.png" alt="" width="24" height="24" align="center"> [shell-yeah](shell-yeah/README.md) | `/sh` runs a command as you, with live output in the chat that the agent sees only if you send it. Commands the agent hands you get a Run button. |

## Install

Expand Down
Loading
Loading