{"id":34021280,"url":"https://github.com/geofront-auth/geofront-cli","last_synced_at":"2026-03-09T08:31:03.386Z","repository":{"id":16217888,"uuid":"18965049","full_name":"geofront-auth/geofront-cli","owner":"geofront-auth","description":"It provides a CLI client for Geofront, a simple SSH key management server.","archived":false,"fork":false,"pushed_at":"2024-04-03T04:25:33.000Z","size":102,"stargazers_count":34,"open_issues_count":5,"forks_count":10,"subscribers_count":26,"default_branch":"master","last_synced_at":"2025-09-25T06:32:49.812Z","etag":null,"topics":["geofront","python","ssh","ssh-key"],"latest_commit_sha":null,"homepage":"https://pypi.python.org/pypi/geofront-cli","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/geofront-auth.png","metadata":{"files":{"readme":"README.rst","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2014-04-20T13:37:43.000Z","updated_at":"2024-04-03T04:25:38.000Z","dependencies_parsed_at":"2022-09-10T18:20:11.068Z","dependency_job_id":null,"html_url":"https://github.com/geofront-auth/geofront-cli","commit_stats":null,"previous_names":["spoqa/geofront-cli"],"tags_count":15,"template":false,"template_full_name":null,"purl":"pkg:github/geofront-auth/geofront-cli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/geofront-auth%2Fgeofront-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/geofront-auth%2Fgeofront-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/geofront-auth%2Fgeofront-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/geofront-auth%2Fgeofront-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/geofront-auth","download_url":"https://codeload.github.com/geofront-auth/geofront-cli/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/geofront-auth%2Fgeofront-cli/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30287800,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-09T02:57:19.223Z","status":"ssl_error","status_checked_at":"2026-03-09T02:56:26.373Z","response_time":61,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["geofront","python","ssh","ssh-key"],"created_at":"2025-12-13T15:51:15.460Z","updated_at":"2026-03-09T08:31:03.375Z","avatar_url":"https://github.com/geofront-auth.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"Geofront CLI client\n===================\n\n.. image:: https://badge.fury.io/py/geofront-cli.svg?\n   :target: https://pypi.python.org/pypi/geofront-cli\n   :alt: Latest PyPI version\n\n.. image:: https://travis-ci.org/spoqa/geofront-cli.svg?\n   :target: https://travis-ci.org/spoqa/geofront-cli\n   :alt: Build status (Travis CI)\n\n.. image:: https://ci.appveyor.com/api/projects/status/wjcgay1b4twffwbc?svg=true\n   :target: https://ci.appveyor.com/project/dahlia/geofront-cli\n   :alt: Build status (AppVeyor)\n\nIt provides a CLI client for Geofront_, a simple SSH key management server.\n\n.. _Geofront: https://geofront.readthedocs.org/\n\n\nInstallation\n------------\n\nIt is available on PyPI__, so you can install it using ``pip`` installer.\nWe, however, recommend to use pipsi_ instead so that geofront-cli and its\ndependencies don't make your global site-packages messy.\n\n.. code-block:: console\n\n   $ pipsi install geofront-cli\n\n__ https://pypi.python.org/pypi/geofront-cli\n.. _pipsi: https://github.com/mitsuhiko/pipsi\n\n\nGetting started\n---------------\n\nWhat you have to do first of all is to configure the Geofront server URL.\nType ``geofront-cli start`` and then it will show a prompt:\n\n.. code-block:: console\n\n   $ geofront-cli start\n   Geofront server URL:\n\nWe suppose ``http://example.com/`` here.  It will open an authentication\npage in your default web browser:\n\n.. code-block:: console\n\n   $ geofront-cli start\n   Geofront server URL: http://example.com/\n   Continue to authenticate in your web browser...\n   Press return to continue\n\n\nList available remotes\n----------------------\n\nYou can list the available remotes using ``geofront-cli remotes`` command:\n\n.. code-block:: console\n\n   $ geofront-cli remotes\n   web-1\n   web-2\n   web-3\n   worker-1\n   worker-2\n   db-1\n   db-2\n\nIf you give ``-v``/``--verbose`` option it will show their actual addresses\nas well:\n\n.. code-block:: console\n\n   $ geofront-cli remotes -v\n   web-1\tubuntu@192.168.0.5\n   web-2\tubuntu@192.168.0.6\n   web-3\tubuntu@192.168.0.7\n   worker-1\tubuntu@192.168.0.25\n   worker-2\tubuntu@192.168.0.26\n   db-1\tubuntu@192.168.0.50\n   db-2\tubuntu@192.168.0.51\n\n\nSSH to remote\n-------------\n\nYou can easily connect to a remote through SSH.  Use ``geofront-cli ssh``\ncommand instead of vanilla ``ssh``:\n\n.. code-block:: console\n\n   $ geofront-cli ssh web-1\n   Welcome to Ubuntu 12.04.3 LTS (GNU/Linux 2.6.32-042stab078.27 i686)\n\n    * Documentation:  https://help.ubuntu.com/\n   ubuntu@web-1:~$\n\nIn most cases, you probably need to list remotes to find an alias to SSH\nbefore run ``geofront-cli ssh`` command.  ``geofront-cli go`` command is\na single command for these two actions at once:\n\n.. code-block:: console\n\n   $ geofront-cli go\n   (...interactive fuzzy finder for remotes is shown...)\n   Welcome to Ubuntu 12.04.3 LTS (GNU/Linux 2.6.32-042stab078.27 i686)\n\n    * Documentation:  https://help.ubuntu.com/\n   ubuntu@web-1:~$\n\nNote that there's a shortcut command ``gfg`` which is an alias of\n``geofront-cli go``.\n\nThere is ``geofront-cli scp`` command as well, which is corresponding\nto ``scp``:\n\n.. code-block:: console\n\n   $ geofront-cli scp file.txt web-1:file.txt\n   file.txt                                      100% 3157     3.1KB/s   00:00\n   $ geofront-cli scp -r web-1:path/etc/apt ./\n   sources.list                                  100% 3157     3.1KB/s   00:00\n   trusted.gpg                                   100%   14KB  13.9KB/s   00:00\n\n\nMissing features\n----------------\n\n- Shortcut for ``geofront-cli ssh`` command\n- Make ``geofront-cli ssh`` similar to ``ssh``\n- Autocompletion\n\n\nAuthor and license\n------------------\n\n`Hong Minhee`__ wrote geofront-cli, and Spoqa_ maintains it.\nIt is licensed under GPLv3_ or later.\n\n__ https://hongminhee.org/\n.. _Spoqa: http://www.spoqa.com/\n.. _GPLv3: http://www.gnu.org/licenses/gpl-3.0.html\n\n\nChangelog\n---------\n\nVersion 0.4.5\n`````````````\n\nTo be released.\n\n\nVersion 0.4.4\n`````````````\n\nReleased on April 03, 2020.\n\n- Fixed some command won't work properly.\n  This bug occured when running ssh or scp command through the other command.\n  (e.g. `geofront-cli go`) [`#19`__ by cynthia]\n\n__ https://github.com/spoqa/geofront-cli/pull/19\n\nVersion 0.4.3\n`````````````\n\nReleased on March 25, 2020.\n\n- Added jump host options to use ProxyJump in SSH. [`#18`__ by cynthia]\n\n__ https://github.com/spoqa/geofront-cli/pull/18\n\n\nVersion 0.4.2\n`````````````\n\nReleased on February 26, 2020.\n\n- Added supporting for LibreSSL. [`#16`__ by cynthia]\n\n__ https://github.com/spoqa/geofront-cli/pull/16\n\n\nVersion 0.4.1\n`````````````\n\nReleased on May 24, 2017.\n\n- Fixed a bug that ``geofront-cli go``/``gfg`` had crashed with\n  ``AttributeError`` when a user cancelled (i.e. Ctrl-C) to select a remote.\n  [`#10`__]\n\n__ https://github.com/spoqa/geofront-cli/issues/10\n\n\nVersion 0.4.0\n`````````````\n\nReleased on May 23, 2017.\n\n- Dropped support of Python 2.6 and 3.2.\n- ``geofront-cli go`` command and its alias shortcut ``gfg`` were introduced.\n  It's an interactive user interface to select a remote and SSH to it at once.\n- Fixed verification failure of SSL certificates when Python was installed\n  using Homebrew on macOS.  Now it depends on Certifi_.\n- Now the output list of ``geofront-cli remotes`` is sorted.\n- The second column of ``geofront-cli remotes --verbose`` result became\n  vertically aligned.\n- The second column of ``geofront-cli remotes --verbose`` result became\n  to omit the port number if it's 22 so that these are easy to copy-and-paste\n  into other SSH programs.\n- Loading spinners became shown when time-taking tasks are running.\n\n.. _Certifi: https://github.com/certifi/python-certifi\n\n\nVersion 0.3.4\n`````````````\n\nReleased on April 3, 2017.\n\n- Fixed ``UnicodeError`` during signing the running Python 3 executable\n  on macOS.\n\n\nVersion 0.3.3\n`````````````\n\nReleased on March 30, 2017.\n\n- Now ``-d``/``--debug`` option prints more debug logs.\n- Fixed `system errors during getting/setting password through keyring/Keychain\n  on macOS due to some unsigned Python executables`__.\n\n__ https://github.com/jaraco/keyring/issues/219\n\n\nVersion 0.3.2\n`````````````\n\nReleased on May 31, 2016.\n\n- Fixed ``ImportError`` on Python 2.6.\n\n\nVersion 0.3.1\n`````````````\n\nReleased on May 28, 2016.\n\n- Forward compatibility with Geofront 0.4.\n\n\nVersion 0.3.0\n`````````````\n\nReleased on January 15, 2016.\n\n- Fixed an ``AttributeError`` during handling error sent by server.\n  [`#4`__]\n\n__ https://github.com/spoqa/geofront-cli/issues/4\n\n\nVersion 0.2.2\n`````````````\n\nReleased on November 14, 2014.\n\n- Added ``-v``/``--version`` option.\n- Fixed an ``AttributeError`` during handling error from server.\n  [`#2`__, `#3`__ by Lee Jaeyoung]\n\n__ https://github.com/spoqa/geofront-cli/issues/2\n__ https://github.com/spoqa/geofront-cli/pull/3\n\n\nVersion 0.2.1\n`````````````\n\nReleased on June 29, 2014.\n\n- Added ``geofront-cli scp`` command.\n- Added the short option ``-S`` for ``--ssh``.\n- It becomes to no more depend on dirspec_.  Instead it's simply bundled\n  together.\n- ``geofront-cli`` now prints a usage description when no subcommand specified.\n\n.. _dirspec: https://pypi.python.org/pypi/dirspec\n\n\nVersion 0.2.0\n`````````````\n\nReleased on May 3, 2014.\n\n- Added handling of unfinished authentication error.\n- Added handling of incompatible protocol version.\n\n\nVersion 0.1.1\n`````````````\n\nReleased on April 22, 2014.\n\n- Fixed Python 2 incompatibility.\n- Added warning for non-SSL server URL.\n\n\nVersion 0.1.0\n`````````````\n\nFirst pre-alpha release.  Released on April 21, 2014.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgeofront-auth%2Fgeofront-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgeofront-auth%2Fgeofront-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgeofront-auth%2Fgeofront-cli/lists"}