Home

Chrome Web Store Chrome Web Store Chrome Web Store Chrome Web Store CircleCI

This is a Chrome extension to manage Google Apps Script(GAS) code with your favorite SCM service(GitHub/GitHub enterprise/Bitbucket/GitLab).

With this extension, you can manage your code in GAS editor, push code to a new created branch, pull from a repository/branch.

1.Install

Install this extension from chrome web store.

2.Usage

Check the demo video for basic usage

After install, when you open GAS editor, a new button will appear to allow you to login to GitHub/GitHub Enterprise/Bitbucket/GitLab.

2.1.Login

Login to your GitHub/GitHub Enterprise/Bitbucket/GitLab account, with Two-factor authentication support for GitHub/GitHub Enterprise. You can also use an existed token for GitHub/GitHub Enterprise/GitLab.

Actually, this is not a login action, but to create the access token which will be used for the extension.

Note: the access token will be stored in chrome.storage.sync(password will not be stored), if you take this as a security hole, please DO NOT use this extension.

You will also be asked to give google permission for Apps Script API, this is to get and update your GAS code.

Currently, the Google OAuth App used is not verified by Google yet since it takes a lot of process (even including taking a youtube video). I’m trying to complete all of them(actually this homepage is one of them) but may take sometime.

So there will be a warn page after you choose the Google account, please go ahead to allow the access otherwise the extension won’t work.

If you feel the warn is scary and don’t want to give access, also please DO NOT use this extension.

2.2.Bind

After login, you can bind your GAS Project with repo and branch, or create a new one.

2.3.Manage

Manage your code with the similar Push and Pull.But there are something you need to know before you use it.

2.3.1.Create Repository/Branch

In Repo and Branch dropdown list, there is an option to Create new Repo and Branch.

New Repo will be created with an init, with a default README.md.

2.3.2.Pull and Push

The PULL/PUSH is not actually the same as GitHub/Bitbucket’s PULL/PUSH, because GAS project does not have any git info, so what we can do is limited.

The differences are:

  • Pull will fetch code from the bind Repository/Branch, and OVERWRITE to current GAS Project. There is no merge operation.
  • Push will make all your change like one commit, If your want to make your process clearly, please push everytime you want a commit.

Other points:

  • A diff dialog will be shown before you confirm to Push or Pull.
  • You can choose files to operate with in the diff dialog.
  • Push must have a commit comment which will be added from the diff dialog.

2.3.2.1 Gist

For using Gist, select Using Gist in the Repo dropdown list, then Branch dropdown will changed to Gist. But since gist do not has a name, you need to select the id to specific which gist to sync(a tooltip will show description of the gist).

Note: Bitbucket’s snippet is not supported.

  • If there is no gist, you can create one from the extension.
  • The gist created from extension will be initialzated with a default init_by_gas_hub.html file, this will be delete when first time you push you code to gist.
  • You can change the description when push.
  • Same as sync to repo, only file added and file changed is supported.

2.4.Logout

You can logout from the extension’s option page any time. After logout, the access token stored in extension will be deleted, but you will need to delete the token or revoke Bitbucket’s oauth yourself from SCM’s settins page.

3.Features

  • Manage code with GitHub, GitHub Enterprise, Bitbucket and GitLab
  • Support embedded scripts
  • Push/Pull code between SCM and GAS
  • Sync code to public/secret Gist
  • Create repo, branch from GAS IDE
  • Diff check when pull/push
  • Choose files to pull/push
  • Support file changed/added/deleted/renamed
  • Add Commit comment when push
  • Support two-factor authentication(GitHub, GitHub Enterprise only)
  • Work with directory(with slash in filename)
  • Support GitHub Organizations, Bitbucket Teams and GitLab Groups.
  • Google Apps Script native ui
  • Option to change filetype from .gs to .js when uploading to SCM
  • Option to add ignore file pattern.

4.Support

please create an issue for any question or bug report.

5.Known issues

  • (Fixed after 5.0.0) .gs file which contains a function with the same name as the file will not work #18. (limited by GAS’S RPC)
  • (Fixed after 5.0.0) Can not work with more than one IDE tab in same browser
  • Can not push to a blank repo without a init commit. (limited by GitHub API)