nassh: support running as an extension

We largely don't need to change anything here.  Just a lot of
documentation updates.

We tweak the nassh code to support the browserAction API.  This is
activated when the icon is clicked.  We use it to launch a window.
In addition, we set the default popup to list existing connections.
The UI here is likely to change, so just putting together something
simple and reasonable for users to start experimenting with.

Finally we tweak the manifests to generate multiple packages.  The
main manifest json is a hand maintained symlink to help with local

We start the extension version off low so we can do some early
experimentation before getting it onto the same release track.

We require Chrome 65+ as those are the first to whitelist us.

Change-Id: I7c0c3e8960b3ba31c15c8bf4c06fccb29a3b7a5a
Tested-by: Mike Frysinger <>
Reviewed-by: Brandon Gilmore <>
16 files changed
tree: 348de8928eb230de27083a27fc1172c1630a8091
  1. .clang-format
  2. .eslintrc.js
  3. .gitignore
  7. hterm/
  8. libdot/
  9. nassh/
  10. package.json
  11. saltpig/
  12. ssh_client/
  13. wam/
  14. wash/


This repository contains the libdot JavaScript library and some web applications that make use of it.

The official copy of this repository is hosted at

There is also a mirror on github at A few subprojects are also extracted out into their own git repo and mirrored. Keep in mind that these mirrors may occasionally be behind the official repository.

All changes must go through the Gerrit code review server on Github pull requests cannot be accepted. Please see the document in this directory for the details.

Top level directories

  • libdot/ is a small set of JS libraries initially developed as part of hterm, now available as shared code.

  • hterm/ is a JS library that provides a terminal emulator. It is reasonably fast, reasonably correct, and reasonably portable across browsers.

  • nassh/ is the Secure Shell Chrome App (currently a “v1.5” app, soon to become a “v2” or platform app) that combines hterm with a NaCl build of OpenSSH to provide a PuTTY-like app for Chrome users.

  • ssh_client/ is the NaCl port of OpenSSH. It is used by nassh to create the Secure Shell App.

  • wash/ is a library for cross-origin virtual filesystems, similar to the Plan 9 filesystem. This directory also contains a simple bash-like shell environment for exploring these filesystems. The code in this directory is a work-in-progress.