Book a Demo!
CoCalc Logo Icon
StoreFeaturesDocsShareSupportNewsAboutPoliciesSign UpSign In
gitpod-io
GitHub Repository: gitpod-io/gitpod
Path: blob/main/components/gitpod-cli/README.md
2492 views

Gitpod CLI

A CLI binary that comes pre-installed within the Gitpod workspace environments.

Description

Here are a few of the things you can do with it:

  • Open a file in the IDE

  • Open a URL in the IDE's preview

  • Watch the progress of a running task defined on .gitpod.yml by attaching the terminal to its process.

  • Control user-defined environment variables

  • Stop the current workspace

  • Notify and wait for events to happen, to control the order of execution of terminal tasks

  • Make a port available on 0.0.0.0 so that it can be exposed to the Internet

  • Wait for a process to listen on a port

  • Print the URL of the current workspace

  • Take a snapshot of the current workspace

  • Create a Gitpod configuration for the current project

Learn more about it by running gp —-help or checking the documentation.

Contributing

  • The Gitpod CLI is written in Go.

  • Most of the functionalities that the CLI implements, make use of the Supervisor API.

If you would like to contribute to this component, check the related GitHub issues or start a discussion in the Discord #contributing channel.

Ownership

To know which Gitpod Team owns this component, check the CODEOWNERS.