Skip to content
⚛️ Simplest way to organize and run tasks
TypeScript JavaScript CSS HTML
Branch: master
Clone or download
Latest commit 229ef17 Feb 4, 2020
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github/ISSUE_TEMPLATE Update issue templates Oct 8, 2019
.vscode Revert "Updates" Sep 27, 2019
app show/hide status bar from config Feb 1, 2020
cli v2.2.1 Jan 20, 2020
docs Upload updated demo images Jan 2, 2020
ui typo Feb 4, 2020
.gitignore add coc, contributing Oct 8, 2019 update Jan 26, 2020
LICENSE Add show message when app hides to tray Dec 23, 2019
db.json Revert "Updates" Sep 27, 2019
dummy-file.js Revert "Updates" Sep 27, 2019
gulpfile.js add scripts to auto update package.json version Dec 23, 2019
package.json bump version to 2.2.0 Dec 31, 2019
yarn.lock Update website with 2.2.0 release assets Jan 2, 2020

Ten Hands Logo

Ten Hands

One place to run your command-line tasks

Build Status

What is this?

Do you keep opening terminals to run your scripts/commands/tasks etc,. If you have to do that everyday for same project (Example running scripts from package.json for multiple projects), Ten Hands makes it easier to organize all your tasks in one place. You can organize tasks into projects and run them whenever you want with a click of a button.


Please visit website to see intro video.

Dark Light


Downloads are available in releases section if you just want to download and run.

Installing browser version

This project can be run in browser instead of desktop version. Before installing browser version, check what additional features the desktop version has currently.

  1. Drag & Drop package.json to add project.
  2. Link to open project directory in file explorer.

To run in browser.

  1. Install ten-hands-cli tool from npm.
  npm install --global ten-hands-cli


  yarn global add ten-hands-cli
  1. Start app
  ten-hands start
  1. Your teminal will show you the localhost address with port where Ten Hands is running. Copy and open it in browser.


A config.json is supported which is placed at ~/.ten-hands/ path.

Check Configration at Wiki for configuration options.

You have to restart the app when you change configuration.


  1. Can I create a project without package.json?

Yes, a project in ten-hands is just a group of tasks for organization purpose. It is not specific for running nodejs based projects. So, if you are not using a nodejs based project, simply create a project with any name. Then add your tasks with any name and command.

  1. Does adding a task in a project updates the project's package.json?

No, when you create a project from package.json, it extracts it's name, scripts, directory path (in desktop version) and saves in it's own database file (~/.ten-hands/db.json). package.json is only useful to quickly create a project from file. You can add more tasks related or unrelated to this nodejs project once a project is created.

  1. I just need to run global commands as tasks. Do I have to give a path? What path do I use?

Yes, in that case, just give some valid path where the command has permissions to execute. Note that if you do not enter a path while creating task, it tries to execute in the project's path.

  1. My app doesn't start.

Try changing the port in config file and restart the app.

  1. My task automatically stops saying process closed with code right after clicking the start button.

Check if task is running at correct path. By default, task is executed in the project directory path if no path entered at task creation time. Relative paths to project path do not work. When you create a task, you either have to enter the whole absolute path where the task needs to execute or leave empty to run it at project's path.

  1. I don't want a desktop app. Is there a browser version available?

Yes, install ten-hands-cli from npm. Check ten-hands-cli for details.

  1. App installation says Ten Hands is from Unknown Publisher(Windows) or unidentified developer(macOS). Is it safe to install?

Of course, every single line of code is open source for you to verify. I just couldn't buy expensive code signing certificates. Google how to install app from unidentified developer for steps to allow app in macOS.


Check CONTRIBUTING for project setup and folder structure details. Please use issue tracker for any kind of bugs/suggestions/discussions.


MIT - Sai Sandeep Vaddi

You can’t perform that action at this time.