Skip to content

block/away

Away

Away is a prototype iOS remote control for goose.

Away connects to an existing goose ACP server and provides a mobile chat-style surface for listing sessions, opening transcripts, and sending prompts.

Requirements

  • Xcode 26 or newer
  • iOS 26 simulator runtime

Swift Package Manager resolves all dependencies from public Apple repositories.

Build And Run

Open Away.xcodeproj in Xcode, select the Away scheme, choose an iOS simulator, and run.

The prototype defaults to SSH stdio transport and runs:

goose acp

The app can be configured with launch environment variables while the connection UI is still prototype-only:

AWAY_TRANSPORT=ssh-stdio
AWAY_SSH_HOST=127.0.0.1
AWAY_SSH_PORT=22
AWAY_SSH_USERNAME=<user>
AWAY_SSH_PASSWORD=<password>
AWAY_SSH_COMMAND=goose acp

For local protocol development, a direct WebSocket shortcut is also available:

AWAY_TRANSPORT=direct-websocket
AWAY_ACP_URL=ws://127.0.0.1:32845/acp?token=local-secret

Test

Run the Away test action in Xcode, or use:

xcodebuild test \
  -project Away.xcodeproj \
  -scheme Away \
  -destination 'platform=iOS Simulator,name=iPhone 17'

About

An iOS remote control for goose

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages