mirror of
https://github.com/All-Hands-AI/OpenHands.git
synced 2026-04-29 03:00:45 -04:00
56 lines
2.1 KiB
Plaintext
56 lines
2.1 KiB
Plaintext
# Openhands Cloud
|
||
|
||
OpenHands Cloud is the cloud hosted version of OpenHands by All Hands AI.
|
||
|
||
## Accessing OpenHands Cloud
|
||
|
||
OpenHands Cloud can be accessed at https://app.all-hands.dev/.
|
||
|
||
## Getting Started
|
||
|
||
After visiting OpenHands Cloud, you will be asked to connect with your GitHub account:
|
||
1. After reading and accepting the terms of service, click `Connect to GitHub`.
|
||
2. Review the permissions requested by OpenHands and then click `Authorize OpenHands AI`.
|
||
- OpenHands will require some permissions from your GitHub account. To read more about these permissions,
|
||
you can click the `Learn more` link on the GitHub authorize page.
|
||
|
||
## Repository Access
|
||
|
||
### Adding Repository Access
|
||
|
||
You can grant OpenHands specific repository access:
|
||
1. Click the `Select a Git project` dropdown, select `Add more repositories...`.
|
||
2. Select the organization, then choose the specific repositories to grant OpenHands access to.
|
||
<details>
|
||
<summary>Permission Details for Repository Access</summary>
|
||
|
||
Openhands requests short-lived tokens (8-hour expiry) with these permissions:
|
||
- Actions: Read and write
|
||
- Administration: Read-only
|
||
- Commit statuses: Read and write
|
||
- Contents: Read and write
|
||
- Issues: Read and write
|
||
- Metadata: Read-only
|
||
- Pull requests: Read and write
|
||
- Webhooks: Read and write
|
||
- Workflows: Read and write
|
||
|
||
Repository access for a user is granted based on:
|
||
- Granted permission for the repository.
|
||
- User's GitHub permissions (owner/collaborator).
|
||
</details>
|
||
|
||
3. Click on `Install & Authorize`.
|
||
|
||
### Modifying Repository Access
|
||
|
||
You can modify repository access at any time by:
|
||
* Using the same `Select a Git project > Add more repositories` workflow, or
|
||
* Visiting the Settings page and selecting `Configure GitHub Repositories` under the `GitHub Settings` section.
|
||
|
||
## Conversation Persistence
|
||
|
||
- Conversations List – Displays only the 10 most recent conversations initiated within the past 10 days.
|
||
- Workspaces – Conversation workspaces are retained for 14 days.
|
||
- Runtimes – Runtimes remain active ("warm") for 30 minutes. After this period, resuming a conversation may take 1–2 minutes.
|