iShell: Commands

Categories Commands
iShell
by iShell Authors
add-settingAdds a new dynamic setting.
Syntax
  • add-setting setting value as setting_key
change-shell-settingsTakes you to the iShell settings page.
Synonims: change-shell-options
debug-modeToggles the debug mode.
debug-popupDebug the popup window in a separate tab.
edit-shell-commandsTakes you to the iShell command editor page.
Synonims: hack-ishell
edit-shell-settingsLive-edit iShell options as text.
installInstalls a command from GitHub gist.
list-shell-commandsOpens iShell command list page.
Synonims: command-list, help
open-backend-logOpen the log file of the native backend application.
reload-shellReloads iShell extension.
view-api-referenceView iShell API reference.
Browser
by iShell Authors
clear-browser-cacheClears the browser cache.
clear-site-cookiesClears cookies and local storage of the currently opened site.
historySearch browsing history.
Author: g/christensen

Syntax

history [filter] [for domain] [of day] [from day] [to day] [by amount]

Arguments

  • filter - arbitrary text, filters history items by title or URL if specified.
  • domain - additional filter by URL.
  • day - {today | yesterday | week | month | YYYY-MM-DD | MM-DD | DD | D}, specifies date to search history for.
  • amount - number, specifies the maximum amount of listed items.

Examples

  • history books from 01 to 10
  • history news for example.com of week by 50
printPrint the current page.
AI
by iShell Authors
gptChat with OpenAI GPT models.
Author: g/christensen | GPL

This command uses OpenAI API to communicate with GPT language models. Please provide the authorization API key on the iShell options page. All arguments are optional.

Syntax

gpt [with model] [by tokens] [at temperature]

Arguments

  • model - language model to use. Available models:
    • gpt-3.5 - gpt-3.5-turbo
    • gpt-4 - gpt-4
    • gpt-4-turbo - gpt-4-turbo-preview
  • tokens - maximum number of tokens in the prompt and output. The current limit is 4096.
  • temperature - sampling temperature. A floating point value between 0 and 2.

Examples

gpt with 3.5 by 1000 at 0.7

  
Tabs
by iShell Authors
close-all-tabs-withCloses all open tabs that have the given word in common.
close-tabCloses the tab whose title or URL matches the input or the current tab if no tab matches.
new-tabCreate a new tab.
Author: g/christensen

The command allows to open multiple links extracted from the active page or selection.

Syntax

new-tab [url] [in container] [for {all | pattern}] [as type] [from source]

Arguments

  • url - an URL to open, optional. If omitted, links are extracted from the active page or selection.
  • container - Firefox identity container.
  • pattern - a pattern to filter links by. All links are opened if the special keyword all is specified.
  • type - a pattern type. Can be:
    • string - plain string (default).
    • regex - regular expression.
  • source - the part of a link to apply the pattern to. The both sources are used if omitted. Can be:
    • url - apply the pattern to the URL of a link.
    • text - apply the pattern to the text of a link.

Examples

  • new-tab in work
  • new-tab for all in work
  • new-tab for /thread.php\?id=\d+$ as regex
switch-to-tabSwitches to the tab whose title or URL matches the input.
tab-groupiShell command for the Lightning Tab Groups extension.
Synonims: tgr
Author: g/christensen

Syntax

tab-group [all | name] [to operation] [in container] [by action] [at name] [for filter] [of color key]

Arguments

  • name - the name of a tab group to create or to operate on. May also be specified in the at argument (it has precedence). The current tab group is assumed if not specified. The keyword all designates all existing tab groups.
  • operation - the operation to perform on a tab group.
    • switch - switch to the tab group with the given name. The tab group will be created if not exists. Performed if the to argument is not specified.
    • copy and paste - copy or paste the tab group to/from the clipboard.
    • reload - reload all tabs in the tab group.
    • close - close all tabs in the tab group.
    • delete - delete the specified tab group.
    • window - open all tabs of the tab group in a new window.
    • move - move all/highlighted tabs from the current window to the specified tab group.
    • move-tab - move the active tab to the specified tab group.
  • action - an additional operation to perform.
    • switching - switch to the specified tab group. May be used with the move and move-tab operations.
  • container - the identity container to use in the tab group.
  • filter - when applicable, filter tabs by this string in the tab URL or title.
  • color key - a digit (0-9) corresponding to the color mnemonic of the tab group.

Examples

  • tab-group cats
  • tgr books in shopping of 8
  • tgr to delete books
  • tgr to close all
  • tgr to move by switching at books for used
Utility
by iShell Authors
base64decodebase64decode
Synonims: b64d, atob
Author: rostok | GPL
base64encodebase64encode
Synonims: b64e, btoa
Author: rostok | GPL
calculateCalculates using JavaScript Expression Evaluator.
Author: satyr | Public domain
Try: 22/7, 3^4^5, sin(sqrt(log(PI)))
color-pickerA color picker based on the spectrum library.

Syntax

color-picker [color] [as format]

Arguments

  • color - a color in any valid web format. The current selection is used if omitted.
  • format - format of the output color value that replaces the current selection. One of the following strings: hex, rgb, hsv, hsl.

Example

color-picker as rgb

current-ipDisplays your current IP address.
isdownCheck if the selected/typed URL is down.
resurrectResurrect a dead page using Internet archiving services.
Author: g/christensen

Syntax

  • resurrect [URL] [with archiving service]

Arguments

  • archiving service - one of the following archiving services:
    • wayback machine latest
    • wayback machine list
    • google cache
    • google cache text only

Example

shorten-urlShorten your URLs with the least possible keystrokes
Synonims: bitly
Author: Cosimo Streppone | GPL
unicodeSearch for Unicode characters.

Copy the character or its code representations to the clipboard by clicking on it.

Syntax

unicode description [with match]

Arguments

  • description - description of a character.
  • match - one of the following strings:
    • words - match full words.
    • partial - match words partially.

Examples

unicode cat with partial

urldecodeDecode an URL using decodeURIComponent
Syntax
  • urldecode URL [by amount]
Arguments
  • - amount - number, number of times to apply decodeURIComponent to the URL.
urlencodeEncode an URL using encodeURIComponent
Search
by iShell Authors
googleSearches Google for your words.
It is possible to use the as argument with the following values: quoted, site, define.
imagesBrowse pictures from Google Images.
Authors: Federico Parodi, satyr, g/christensen
imdbSearches IMDB for movies.
libgenSearch Library Genesis.

Syntax

libgen [query] [of order] [with sort mode] [by amount]

Arguments

  • query - arbitrary text, queries books by title or author.
  • order - {title | author | year }, specifies the column to order by.
  • sort mode - {asc | desc}, specifies sort mode.
  • amount - {25 | 50 | 100 }, specifies the maximum amount of listed items.

Example

libgen philosophical investigations of year by 50

mapsShows a location on the map.
Author: rostok
scihubSearch for articles on SCI-HUB.
stackoverflowSearch for questions on stackoverflow.com.
wikipediaSearches Wikipedia for your words, in a given language (by the in argument).
Author: Blair McBride
youtubeSearches YouTube for videos matching your words. Previews the top results.
Syndication
by iShell Authors
feedsubSubscribe to RSS feeds in Feedly.
The command uses the URL opened in the current tab. Can also subscribe to YouTube users and channels.
pinterestPin images to a board on Pinterest.

To create a pin, fill in the arguments and click on an image in the preview area or press the corresponding Ctrl+Alt+<key> combination. A user should be logged in to Pinterest to use this command. Execute the command to open the chosen board.

Syntax

pinterest [description] to board [of dimension]

Arguments

  • description - a comment to the pin being created.
  • board - a name of the board to attach the pin to. Created if not exists.
  • size - minimal size of the images displayed in the command preview. 500 pixels is the default.

Examples

pinterest to cats of 1000 Nice kitty

Mail
by iShell Authors
composeCompose an empty email with the given subject using Gmail.
Author: g/christensen

Syntax

  • compose message subject to email address [at account]

Arguments

  • email address - recipient's address: a valid email address
  • account - gmail account: {default, secondary}

Example

  • compose shopping list to user@example.com at secondary
emailCompose an email with the current selection as the body using Gmail.
Author: g/christensen

Syntax

  • email this to email address [at account]

Arguments

  • this - the mandatory keyword used as a substitution for the selection, an arbitrary text may be used instead
  • email address - recipient's address: a valid email address
  • account - gmail account: {default, secondary}

Example

  • email this to *user@example.com at secondary
forget-emailForget any or all remembered emails.
Author: g/christensen

Syntax

  • forget-email [all | email address] [with regex]

Arguments

  • email address - recipient's address: a valid email address. All email are forgotten in the keyword all is used.
  • regex - forget emails that match the specified regex.

Examples

  • forget-email user@example.com
  • forget-email with users?
  • forget-email all
Translation
by iShell Authors
lingvoTranslate words using Abbyy Lingvo online service.
Author: g/christensen

Syntax

lingvo {[this] | words} [from language] [to language]

Arguments

  • language - a valid language name supported by Lingvo

Example

lingvo espoir from french to russian

translateTranslates from one language to another using Bing Translator.
Author: satyr
Syntax
  • translate {[this] | text} [from language] [to language]
Arguments
  • - language - a valid language name supported by Bing Translator
Example
  • translate mother from english to chinese

It works on the selected text in any web page, but there is a limit (a couple of paragraphs) to how much it can translate at once. If you want to translate a lot of text, use translate-page command instead.

translate-pageTranslates a whole page to the specified language using Google Translate.
Author: satyr
Scrapyard
by iShell Authors
archiveArchive a web-page or selection to Scrapyard.

Syntax

archive [this | title] [to path] [as tags] [for details] [with todo] [on due]

Arguments

  • this - may be required if iShell offers incorrect suggestions.
  • title - bookmark title. The current tab name used if not specified.
  • path - the folder to save archive into. The default shelf is designated by '~' character.
  • tags - assigns a comma-separated list of tags to the created archive.
  • details - fills the 'Details' property.
  • todo - sets bookmark TODO state.
  • due - sets bookmark TODO deadline.

Examples

  • archive this to ~/wiki as chem with todo on 10 for research
archive-siteArchive a site or selected links from the current page.

Syntax

Same as archive.

bookmarkBookmark a web-page to Scrapyard.

Syntax

Same as archive.

copy-toCopy selected bookmarks at the destination folder.

Syntax

copy-to path [by action]

Arguments

  • path - path of the destination folder.
  • action - action to take after copying:
    • switching - switch to the destination folder.

Example

  • copy-to ~/wiki by switching
move-toCopy selected bookmarks at the destination folder.

Syntax

Same as copy-to.

notesInstantly create and edit notes at the specified location.

Syntax

Same as archive.

scrapyardList and filter Scrapyard bookmarks.

Syntax

scrapyard [filter] [at path] [from depth] [in type] [as tags] [by amount]

Arguments

  • filter - arbitrary text, filters bookmarks by title, URL or content, depending on type parameter.
  • path - limits the scope of search to the specified path. The default shelf is designated by '~' character.
  • depth
    • folder - return only bookmarks found in the specified path.
    • subtree - search in subfolders (default).
  • type
    • bookmark - return only bookmarks.
    • archive - return only archives.
    • content - search by content.
    • folder - search for folders.
  • tags - filter bookmarks by comma-separated list of tags.
  • amount - number, specifies the maximum amount of listed items.

Examples

  • scrapyard important at ~/papers as news
  • scrapyard notes at clips/misc from group in content
shelfSwitch to or create a shelf in Scrapyard.