Skip to content

Enable direct Mercury mobile access with native Orca service #137

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
maxexcloo wants to merge 1 commit into from
Closed

Enable direct Mercury mobile access with native Orca service #137

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
34 changes: 34 additions & 0 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -104,6 +104,40 @@ Run `atuin mcp install` to register the native stdio server with installed agent
then restart them. This grants read access to shell history and captured threads;
see [native MCP setup](https://docs.atuin.sh/18.24/ai/mcp/).

## Remote Orca

On Linux, chezmoi installs Orca's [server-only distribution](https://github.com/stablyai/orca/blob/v1.4.257/docs/site/content/docs/remote-servers.mdx)
in `~/.local/share/orca-server`, without starting it. Its native mobile app can
connect directly to Mercury over Tailscale while the Mac is off.

After review, install Orca's native user service against the existing profile:

```sh
export ORCA_USER_DATA_PATH="$HOME/.orca"
orca="$HOME/.local/share/orca-server/bin/orca-ide"
"$orca" serve service install --command "$orca" --port 6768 --bind 0.0.0.0 --refuse-public
sudo loginctl enable-linger "$USER"
"$orca" serve service status
```

The supervisor waits for the existing SSH-managed runtime to exit. Arrange an
approved graceful handover, preserving its terminal daemon, profile, sessions
and identities; do not start a second runtime. The new listener permits LAN and
Tailscale clients, subject to the host firewall, and refuses public sources.

Pair directly on Mercury; keep the generated links and QR codes private:

```sh
"$orca" pair --mobile --address mercury.mbk.excloo.net
"$orca" pair --address mercury.mbk.excloo.net
```

Verify an existing session from the phone with the Mac off. After an approved
Mercury reboot, verify access before any SSH login. A healthy service alone does
not prove either workflow. The standalone package lacks browser panes, dictation
and the paired web client; the native mobile app is supported. Chezmoi updates
the package; updates take effect at the next approved runtime restart.

## Shared Agent Guidance

Clone the Agents repository beside this checkout. Chezmoi links its shared
Expand Down
8 changes: 8 additions & 0 deletions home/.chezmoiexternals/orca.toml.tmpl
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
{{- if eq .chezmoi.os "linux" }}
[".local/share/orca-server"]
type = "archive"
exact = true
stripComponents = 1
# renovate: datasource=github-releases depName=stablyai/orca
url = "https://github.com/stablyai/orca/releases/download/v1.4.257/orca-server-linux-{{ .chezmoi.arch | replace "amd64" "x64" }}.tar.gz"
{{- end }}
Loading