saisandeepvaddi / ten-hands

⚡ Simplest way to organize and run command-line tasks

Ten Hands

One place to run your command-line tasks

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.

UI

Please visit website to see intro video.

Dark	Light

Downloads

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

If you want to get latest updates, you can click on "Azure Pipelines" badge above to download latest builds from CI. These may have small bugs. But, please create an issue if you find any.

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

  (or)

  yarn global add ten-hands-cli

2. Start app

  ten-hands start

3. Your teminal will show you the localhost address with port where Ten Hands is running. Copy and open it in browser.

Configuration

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.

FAQ

FAQ section has been moved to Wiki at FAQ.

Contributions

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

Thank you

Thank you Sentry for supporting this Open Source project with their Sentry for Open Source initiative.

ten-hands's Issues

[FEATURE REQUEST]Record timestamp of a task last run

Is your feature request related to a problem? Please describe.
May be it is just me but I run few tasks plenty of times a day and most of the time forget when was the last time I ran. ;)

Describe the solution you'd like
Until the logging is implemented (if at all),, can we have record timestamp of when the task was last run please? This could be an additional entry in the db which should be easy on app.

Additional context
Add any other context or screenshots about the feature request here.

Though no tasks running, when quitting I get a task running alert/warning

OS: Windows 10 Pro 20H1 19041.264 Insider 64bit build

Where: Desktop App

Describe the bug
Though no tasks running, when quitting I get a task running alert/warning

To Reproduce
Try to quit when no rask running

Expected behavior
Quitting without any alerts/warnings

Screenshots

Additional context

Remove Dead code. There is a loooooooooot

Add auto-launch on startup action

Serve UI from server

Application does not launch on debugging message

• Debian 10 Buster, last version
• Desktop App
• The application does not start.

Here are the measures I have taken:

1. change the port in config file > no result
2. uninstall app completely and remove all configuration files everywhere > no
3. execute from the Terminal. It gives this error + debugging message:
   [11901:0320/145359.007916:FATAL:setuid_sandbox_host.cc(157)] The SUID sandbox helper binary was found, but is not configured correctly. Rather than run without sandboxing I'm aborting now. You need to make sure that /opt/Ten Hands/chrome-sandbox is owned by root and has mode 4755. Trace/breakpoint trap
4. I then follow the advice and change both owner and mode of chrome-sandbox > it sends the debugging message Trace/breakpoint trap only now and the application still does NOT start.
5. I recently switched to Debian from Ubuntu 18.10. It was working well on Ubuntu.

Characters not displaying correctly

OS: Windows v2.0.1

Where: Desktop App

Describe the bug
Some command line tools output non-ASCII characters, such as ╬, ═, ─, etc. However, in Ten Hands these all display as a question mark contained within a diamond.

To Reproduce
Execute a command that outputs characters such as ╬, ═, ─,

Expected behavior
All characters should be displayed just as they are in the standard Windows command line, comemu etc

[FEATURE REQUEST] Setting: load all tasks closed

Currently, when opening TenHands or switching from a project to another, the tasks are "open", having the terminal window visible.
As soon as a task has been developed and tested, this should not be the normal display. Instead, there should be a setting that forces the tasks to be displayed closed.

[FEATURE REQUEST] Option to minimise to tray bar on Windows

Is your feature request related to a problem? Please describe.
When working I tend to have a lot of Windows open, and it's useful to be able to minimise some things to the Windows tray bar. I can do this with Cmder, for example, so it's always there when I need it, without me having to restart it.

Describe the solution you'd like
I'd like to optionally be able to minimise the Ten Hands window to the Windows tray bar.

Show git branch in ProjectTopBar if git exists.

[FEATURE REQUEST] To be able to copy Project and Tasks

Is your feature request related to a problem? Please describe.
At the moment, there is no way to copy project or a task which can be quite useful. I can workaround by editing db.json.

Describe the solution you'd like
It would be helpful it can be done on touch of a button from the UI please.

Add support for auto-updates

Command not working

OS: Windows/Linux/macOS with build

$ lsb_release -a
No LSB modules are available.
Distributor ID: Ubuntu
Description:    Ubuntu 18.04.2 LTS
Release:        18.04
Codename:       bionic

Describe the bug
I start the command and it's either not doing anything or outputting an error

To Reproduce
start any command

Expected behavior
will work and output logs like if running dircetly in terminal

Screenshots

How would I debug this?

[FEATURE REQUEST] Allow the use of alternative shells

Is your feature request related to a problem? Please describe.
No

Describe the solution you'd like
I run Ten Hands on Windows 10, but by default, Ten Hands uses CMD on Windows.
This causes my scripts to not run because they rely on Bash.
Would it be possible to have support for additional shells besides CMD?

Additional context
I personally run Bash by means of Git Bash, but I see other users that would like to use Powershell.
So I think these should be the shells that are supported by default (on Windows) and allow for the addition of custom shells by the user if they use something else.

[FEATURE REQUEST] Create Ten Hands update server.

To use something like https://github.com/zeit/hazel

Keep the last opened project on any change.

Vim like keyboard shortcuts

navigate between tasks with hjkl keys, and start/stop each task with a key (spacebar might be a good default)

scp and ssh commands do not show the console output

OS: Windows 10 Pro 64bit Insider build (19041.264) 20H1

Where: Desktop App

Describe the bug
When using OpenSSH scp or ssh, the console output which is visible on CMD or Powershell is not visible on app

To Reproduce
Run scp or ssh to check

Expected behavior
With scp, progress bar of upload to be shown. With SSH, console output shouuld be shown

Screenshots

Additional context

[FEATURE REQUEST]Option to auto start tasks on app load

Is your feature request related to a problem? Please describe.
I have few tasks I definitely run when I start the app but at the moment I have to manually start them.

Describe the solution you'd like
Auto starting the tasks when I open the app will be quitey helpful.

Additional context
Add any other context or screenshots about the feature request here.

[FEATURE REQUEST] Ability to run tasks from the TaskBar tray

Describe the solution you'd like
It would be nice to run tasks without opening the whole window, directly from the taskbar.

Additional context

Unable to type in the terminal after running the script

OS: Windows/Linux/macOS with build
Windows

Where: Desktop App / Web
Desktop

Describe the bug
When a script is run, if the script requires additional parameters, the user is unable to type in the terminal to provide the data that was asked.

To Reproduce
Run any simple script that requires user input after running.

Expected behavior
User should be able to type in the terminal

Screenshots
If applicable, add screenshots to help explain your problem.

Additional context
Add any other context about the problem here.

[FEATURE REQUEST] Global hotkey on Windows

Is your feature request related to a problem? Please describe.
Kind of following on from #101, it's useful to be able to quickly toggle minimised/maximised state of windows using a global hot key. For example, I can do this with Cmder, such that I can quickly hide/restore it to/from the Windows tray bar at the touch of a button

Describe the solution you'd like
I'd like to be able to configure a global hotkey that can be used to minimise Ten Hands to the Windows tray bar, or restore it from the tray bar.

When All projects are deleted it is still showing tasks in one project

[FEATURE REQUEST] Search functionality

Is your feature request related to a problem? Please describe.
Add fuzzy search that will take you to the task directly.

Open file-explorer from browser version

Currently project folder can be opened in desktop version.
We need to be able to open file explorer from browser version too.

May be something like https://github.com/vibhor1997a/nodejs-open-file-explorer.

[FEATURE REQUEST]Can tasks have user input before they run?

Is your feature request related to a problem? Please describe.
Sorry to bombard you with so many requests. Please feel free to ignore them if you are busy. :)

At the moment task just runs but if the command has input parameters, then task needs to be edited each time, saved and run

Describe the solution you'd like
If there is a way, we can set dynamic params when creating tasks, it would be a good addon,

For example xyz.bat takes 2 input params 3 and 4.

The task saved would look like xyz.bat 3 4

Now if I want to change the params, I have to edit the task, make changes, save and run it again.

Now the solution expected is, if we can make params dynamic i.e. xyz.bat &1 &2 and save the task. When the task is run, app pop's up input boxes for params and when entered, task continues to run with the entered params.

Hope I was clear.

Additional context
Add any other context or screenshots about the feature request here.

[FEATURE REQUEST] Being able to sort tasks in different manners

Of course, I know one can change the order of the tasks by modifying the underlying JSON project file.
But it would be nice to be able to sort tasks according to different criteria:

• last execution
• name

Check sidebar overflow-y by adding many projects

Using custom shell opens new window

OS: Windows 10 Pro Build 18362

Where: Desktop App

Describe the bug
When I run my task using a custom shell (git-bash.exe in my case), Ten Hands opens a new window for this shell rather than display it in the Ten Hands UI

To Reproduce
Steps to reproduce the behavior:

1. Install Git Bash
2. Point task to use git-bash.exe
3. Run task

Expected behavior
The console output being shown in Ten Hands rather than a new window

Screenshots
Location of the window in the screenshot is just for demonstrational purposes

[FEATURE REQUEST] Can the last run output remain until task run again?

Is your feature request related to a problem? Please describe.
At the moment there is no way to remember what was the output of a task run last

Describe the solution you'd like
It would be really helpful if the output remains until it ran the next time i.e. even after app is closed and re-opened. Timestamp of both start and complete will be good as well.

Additional context
May be not everyone would prefer this but this could a configuration option for users to decide

Add task re-order feature

Part of v2.0.0.

Add a menu item in project topbar which opens up a drag & drop reorderable.

Once reordering modal is closed, you can see reordered list.

Add edit task support

Add commands from new project creation form

[FEATURE REQUEST] Making tasks of a project to run one after the other

Is your feature request related to a problem? Please describe.
At the moment if we hit Run All on a project, all the tasks begin together. This is certainly useful and expected behavior.

Describe the solution you'd like
If possible, I would also like to have the option to run all of them one after the other too.

[FEATURE REQUEST] Can you please add so that one can copy text from the output terminals

Is your feature request related to a problem? Please describe.
At the moment there is no way of copying output text from the built-in terminals.

Describe the solution you'd like
It would be really helpful if I can select the text within the terminal and either press CTRL+C or right-click and press copy to copy the outputted text to use in another application.

Launch all tasks in project at once

Some weird issue

Keep last x characters only in view

Disable delete while task is running.

Currently, task can be deleted while it is running. It can cause long running processes to keep running and take resources while user forgets they deleted task in Ten Hands.

Update README before 1st release

[Feature Request] Any chance of adding notifications to this app please?

Hi Sai Sandeep,

Thanks for this excellent app which is a time saver. :)

I was wondering if you could add notifications to the tasks please. If a task runs for few minutes, it would a great feature to receive notification so that we do not have to keep monitoring the task.

Hope I made sense.

Update Website

Currently website has download buttons and an introduction video.

Add more content to explain features and usage.

Website is in docs folder.

Make New project drawer informative

1. Let people know they can create empty project and add commands later
2. Change the upload file button helpText. CLI is not in this release.

Throttle localForage updates

No error when package.json doesn't have scripts || name

Make it single instance

[FEATURE REQUEST] Add support for coloured output

Is your feature request related to a problem? Please describe.
Many command line tools emit coloured text, for example to highlight error messages. At present, at least on Windows Ten Hands displays all text in the same colour.

Describe the solution you'd like
I'd like Ten Hands to display coloured output, such that it displays the same as in the standard Windows console host, conemu etc

README description is confusing

The description in the readme is a bit confusing here

[...] for same project (example running scripts from package.json for multiple projects)

UI issue when window is not fully maximized

OS: Windows/Linux/macOS with build
Windows

Where: Desktop App / Web
Desktop

Describe the bug
When the desktop app is not fully maximized, some of the UI elements are not visible.

To Reproduce
Steps to reproduce the behavior:

Expected behavior
A clear and concise description of what you expected to happen.

Screenshots
If applicable, add screenshots to help explain your problem.

Additional context
Add any other context about the problem here.

Allow copy from terminals