ghost/linux-command-library

Linux Command Library (F-Droid): an offline reference of thousands of Linux commands. Search a command, open its page and read the TLDR examples, synopsis, description and parameters. No account.

Runs 6.7× fewer tokens Score 37/100 Official hard skill python

Token savings

85% fewer tokens
Tokenswithout203,190with30,432 (85% fewer)
Timewithout35.4 swith45.2 s (28% more time)
Tool callswithout11with4 (64% fewer)

Agent run: finished without the skill, finished with it (not independently checked).

One recorded run each way, claude-haiku-5-5, same phone and same prompt. Watch it in the Before / after tab.

Recorded: open_library · live agent session on a real phone

Control Linux Command Library on Android with an AI agent

Control Linux Command Library on Android with an AI agent. Look up Linux commands offline: an agent searches a command and reads its examples, synopsis and options.

Target search phrase: AI agent looks up Linux commands on Android

Demo shows: search_commands (query=tar)

Ghost in the Droid seed skill for Linux Command Library (com.inspiredandroid.linuxcommandbibliotheca), an offline reference of Linux commands. Search results, section headers and the text of each section are plain nodes, so an agent can look up exact examples and options. Offline, no account.

ActionWhat it doesParams
open_libraryRestart the app and read the start screen.none
search_commandsSearch commands by name; returns the number of matches and the first result names.query
open_commandOpen a command page by its exact name (searches for it first if needed) and list its sections.name
read_sectionRead one section of the open command page: TLDR (default, example pairs), SYNOPSIS, DESCRIPTION, PARAMETERS, INSTALL, CAVEATS, HISTORY or SEE ALSO.section
get_stateRead the current screen: start, search results or an open command with its visible sections.none

Toolkit

An agent can drive the whole app with these; compose them.

RoleAction
Entryopen_library
Primitivessearch_commands, open_command, read_section
Read stateget_state

Install

The app: F-Droid, or https://f-droid.org/packages/com.inspiredandroid.linuxcommandbibliotheca/. The skill:

pip install "ghost-in-the-droid>=1.6.0"   # 1.6.0 is not on PyPI yet: until it ships, git clone the repo and `pip install -e .`
ghost skill install ghost/linux-command-library

Use

ghost skill run ghost/linux-command-library open_command --param name=tar --device <serial>
ghost skill run ghost/linux-command-library read_section --param section=TLDR --device <serial>
run_skill(name="ghost/linux-command-library", action="read_section", params={"section": "TLDR"})
# {"result": {"lines": ["Create an archive from files", "tar -cvf [archive.tar] [file1] [file2]", ...]}}

Try asking: "Open the tar command in the Linux command library and tell me how to extract a gzip compressed archive."

Tested on

Real Samsung phone, Android 13 (720x1600, 300 dpi, en-GB), Linux Command Library 175. License: MIT.

Known failure modes and versions tested

Versions tested

App versionAndroidDeviceSkill versionDates
17513Samsung real phone (720x1600, 300 dpi, en-GB)1.0.02026-11-02

Recorded failures

  • Not every command has every section; read_section lists the sections it found when one is missing.
  • open_command needs the exact name; use search_commands to find it.
  • Long sections are read by scrolling, which can take several seconds.

Popups and first-run screens handled

  • None.

Try a sample prompt or run an action by name. Replace any parameters in braces with your own values.

open_library

Play demo

Try asking

  • Open the Linux command library
  • open Linux Command Library
ghost skill run ghost/linux-command-library open_library

search_commands

Play demo

Try asking

  • Search the Linux command library for tar
  • find the grep command
  • which commands contain zip
ghost skill run ghost/linux-command-library search_commands

open_command

Play demo

Try asking

  • Open the tar command page
  • show me the man page of grep
ghost skill run ghost/linux-command-library open_command

read_section

Play demo

Try asking

  • Read the TLDR examples of the open command
  • what is the synopsis
  • read the description
ghost skill run ghost/linux-command-library read_section

get_state

Play demo

Try asking

  • What is the Linux command library showing?
  • which command page is open
ghost skill run ghost/linux-command-library get_state