@heyputer/shell 2.1.0

package/.claude/settings.local.json

@@ -0,0 +1,9 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(npm test:*)"
+    ],
+    "deny": [],
+    "ask": []
+  }
+}

package/.env.example

@@ -0,0 +1,3 @@
+# Default Puter's API
+PUTER_API_BASE='http://api.puter.localhost:4100'
+PUTER_BASE_URL='http://puter.localhost:4100'

package/.github/workflows/npm-build.yml

@@ -0,0 +1,34 @@
+# This workflow will run tests using node on every push and pull request
+name: Build package
+
+on: [push, pull_request]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        node-version: ['20.x', '22.x', '24.x']
+    steps:
+    - uses: actions/checkout@v4
+    - name: Install pnpm
+      uses: pnpm/action-setup@v4
+      with:
+        version: 8
+    - name: Use Node.js ${{ matrix.node-version }}
+      uses: actions/setup-node@v4
+      with:
+        node-version: ${{ matrix.node-version }}
+        cache: 'pnpm'
+    - name: Install dependencies
+      run: pnpm install --frozen-lockfile
+    - name: Run tests & coverage
+      run: pnpm run coverage
+    - name: Upload coverage reports to Codecov
+      if: github.event_name != 'pull_request'
+      uses: codecov/codecov-action@v5
+      with:
+        token: ${{ secrets.CODECOV_TOKEN }}
+        slug: HeyPuter/puter-cli
+      

package/.github/workflows/npm-publish.yml

@@ -0,0 +1,50 @@
+# This workflow will run tests using node and then publish a package to GitHub Packages when a release is created
+# For more information see: https://docs.github.com/en/actions/publishing-packages/publishing-nodejs-packages
+
+name: Publish package
+
+on:
+  push:
+    tags:
+      - 'v*.*.*'
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Install pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 8
+      - name: Use Node.js 20
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: 'pnpm'
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+      - name: Run tests
+        run: pnpm test
+
+  publish-npm:
+    needs: build
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Install pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 8
+      - name: Use Node.js 20
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          registry-url: https://registry.npmjs.org/
+          cache: 'pnpm'
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+      - name: Publish to npm
+        run: pnpm publish --no-git-checks
+        env:
+          NODE_AUTH_TOKEN: ${{secrets.npm_token}}

package/.idx/dev.nix

@@ -0,0 +1,53 @@
+# To learn more about how to use Nix to configure your environment
+# see: https://developers.google.com/idx/guides/customize-idx-env
+{ pkgs, ... }: {
+  # Which nixpkgs channel to use.
+  channel = "stable-24.05"; # or "unstable"
+  # Use https://search.nixos.org/packages to find packages
+  packages = [
+    # pkgs.go
+    # pkgs.python311
+    # pkgs.python311Packages.pip
+    pkgs.nodejs_20
+    pkgs.nodePackages.nodemon
+  ];
+  # Sets environment variables in the workspace
+  env = {};
+  idx = {
+    # Search for the extensions you want on https://open-vsx.org/ and use "publisher.id"
+    extensions = [
+      # "vscodevim.vim"
+    ];
+    # Enable previews
+    previews = {
+      enable = true;
+      previews = {
+        # web = {
+        #   # Example: run "npm run dev" with PORT set to IDX's defined port for previews,
+        #   # and show it in IDX's web preview panel
+        #   command = ["npm" "run" "dev"];
+        #   manager = "web";
+        #   env = {
+        #     # Environment variables to set for your server
+        #     PORT = "$PORT";
+        #   };
+        # };
+      };
+    };
+    # Workspace lifecycle hooks
+    workspace = {
+      # Runs when a workspace is first created
+      onCreate = {
+        # Example: install JS dependencies from NPM
+        # npm-install = "npm install";
+        # Open editors for the following files by default, if they exist:
+        default.openFiles = [ ".idx/dev.nix" "README.md" ];
+      };
+      # Runs when the workspace is (re)started
+      onStart = {
+        # Example: start a background task to watch and re-build backend code
+        # watch-backend = "npm run watch-backend";
+      };
+    };
+  };
+}

package/CHANGELOG.md

@@ -0,0 +1,292 @@
+### Changelog
+
+All notable changes to this project will be documented in this file. Dates are displayed in UTC.
+
+Generated by [`auto-changelog`](https://github.com/CookPete/auto-changelog).
+
+#### [v2.0.0](https://github.com/HeyPuter/puter-cli/compare/v1.8.6...v2.0.0)
+
+- Add browser based login [`#75`](https://github.com/HeyPuter/puter-cli/pull/75)
+- Adjust actions for PR test [`#73`](https://github.com/HeyPuter/puter-cli/pull/73)
+- Add test for file commands [`#69`](https://github.com/HeyPuter/puter-cli/pull/69)
+- Add deploy test [`#68`](https://github.com/HeyPuter/puter-cli/pull/68)
+- Add executor test [`#67`](https://github.com/HeyPuter/puter-cli/pull/67)
+- Add ProfileModule test [`#66`](https://github.com/HeyPuter/puter-cli/pull/66)
+- Add commons.test.js [`#64`](https://github.com/HeyPuter/puter-cli/pull/64)
+- Add test shell [`#65`](https://github.com/HeyPuter/puter-cli/pull/65)
+- Add PuterModule test [`#63`](https://github.com/HeyPuter/puter-cli/pull/63)
+- Add test error module [`#62`](https://github.com/HeyPuter/puter-cli/pull/62)
+- Add subdomains test [`#61`](https://github.com/HeyPuter/puter-cli/pull/61)
+- Add sites test [`#60`](https://github.com/HeyPuter/puter-cli/pull/60)
+- Fix first init puter module [`#59`](https://github.com/HeyPuter/puter-cli/pull/59)
+- Fix puter module causing unref error [`#52`](https://github.com/HeyPuter/puter-cli/pull/52)
+- Migrate drivers call to Puter.js NPM [`#33`](https://github.com/HeyPuter/puter-cli/pull/33)
+- Add non interactive puter site deploy [`#30`](https://github.com/HeyPuter/puter-cli/pull/30)
+- Set program name to be hardcoded puter string [`#32`](https://github.com/HeyPuter/puter-cli/pull/32)
+- Enable site:deploy redeploy under same subdomain [`#26`](https://github.com/HeyPuter/puter-cli/pull/26)
+- Fix CLI close unexpectedly when first login [`#29`](https://github.com/HeyPuter/puter-cli/pull/29)
+- Fix logout [`#28`](https://github.com/HeyPuter/puter-cli/pull/28)
+- Site deploy from local dir [`#25`](https://github.com/HeyPuter/puter-cli/pull/25)
+- Fix CI [`0b189de`](https://github.com/HeyPuter/puter-cli/commit/0b189dede790280bdf6e2a4691843970eb7ea83f)
+- Init puter js npm [`b1bd5e7`](https://github.com/HeyPuter/puter-cli/commit/b1bd5e78a232391a2102e85e3ee0c0665ed1a00b)
+- Update pnpm-lock.yaml [`9f7f8fc`](https://github.com/HeyPuter/puter-cli/commit/9f7f8fc7921427a580fe0bb8ca0dd10fe5db8b6b)
+
+#### [v1.8.6](https://github.com/HeyPuter/puter-cli/compare/v1.8.5...v1.8.6)
+
+> 8 October 2025
+
+- Use random name if not specified for `site:deploy` [`#24`](https://github.com/HeyPuter/puter-cli/pull/24)
+- Use random name if not specified [`48ae3f0`](https://github.com/HeyPuter/puter-cli/commit/48ae3f04325f27b654e00050c7ec514bee72535e)
+- docs(readme): update site command [`aa4ba6e`](https://github.com/HeyPuter/puter-cli/commit/aa4ba6e1ee52e1c6e2c0cb5fb74c120fb1b5c0c3)
+- refactor(site): remove name argument from site:deploy [`1ffaacb`](https://github.com/HeyPuter/puter-cli/commit/1ffaacbd3e00dff4f75af66bd1d4b9aee1daf9c6)
+
+#### [v1.8.5](https://github.com/HeyPuter/puter-cli/compare/v1.8.4...v1.8.5)
+
+> 5 October 2025
+
+- feat(site): add site:deploy command for one-step project deployment [`94210ed`](https://github.com/HeyPuter/puter-cli/commit/94210ed796e7564647f4cd177a1b0bef72e66ef2)
+- Fix and add some details to the README file [`8acb6ea`](https://github.com/HeyPuter/puter-cli/commit/8acb6ea753b4f83c146f26473f61756e613a4953)
+- fix(files): touch command to creation a new file [`d30a067`](https://github.com/HeyPuter/puter-cli/commit/d30a0673e9aa5fb5b5d6b037a6a134a196a27529)
+
+#### [v1.8.4](https://github.com/HeyPuter/puter-cli/compare/v1.8.3...v1.8.4)
+
+> 20 September 2025
+
+- fix(app): improve `app:delete` argument validation and usage [`eda41cd`](https://github.com/HeyPuter/puter-cli/commit/eda41cd7c623b8a3f0c60f586de756d4369face3)
+
+#### [v1.8.3](https://github.com/HeyPuter/puter-cli/compare/v1.8.2...v1.8.3)
+
+> 20 September 2025
+
+- fix(app): improve `app:create` validation and usage [`73fc030`](https://github.com/HeyPuter/puter-cli/commit/73fc0300e244a7e94f16d266bfad6128528144b6)
+- chore(config): add ignore patterns for AI tools and agent files [`2b19d6c`](https://github.com/HeyPuter/puter-cli/commit/2b19d6c4c8233d560d4ca16820b3f601875b6c79)
+
+#### [v1.8.2](https://github.com/HeyPuter/puter-cli/compare/v1.8.1...v1.8.2)
+
+> 18 September 2025
+
+- feat: support multiple user profiles and hosts [`#12`](https://github.com/HeyPuter/puter-cli/pull/12)
+- feat: merge profile feature and fix tests [`f234bc2`](https://github.com/HeyPuter/puter-cli/commit/f234bc2704047f39d2899962cd2aaa63df8331ce)
+- ci: revert to pnpm for publishing [`dcd2fbc`](https://github.com/HeyPuter/puter-cli/commit/dcd2fbcbb8f9b5c5cb115a6c90a7e1e5225a2854)
+- fix(ci): improve pnpm lockfile handling in publish workflow [`4731270`](https://github.com/HeyPuter/puter-cli/commit/4731270c3fcd4e4b855c3e1e2f77dbf79ed4ee4b)
+
+#### [v1.8.1](https://github.com/HeyPuter/puter-cli/compare/v1.8.0...v1.8.1)
+
+> 16 April 2025
+
+- fix: better version status handling and error resilience [`ab467e8`](https://github.com/HeyPuter/puter-cli/commit/ab467e8e57cb4f82619424b12136724904df0302)
+
+#### [v1.8.0](https://github.com/HeyPuter/puter-cli/compare/v1.7.3...v1.8.0)
+
+> 2 April 2025
+
+- feat(files): add edit command to modify remote files with local editor [`220b07c`](https://github.com/HeyPuter/puter-cli/commit/220b07c79fa9e9ab2e0e668cfbd7e5260c9746a2)
+
+#### [v1.7.3](https://github.com/HeyPuter/puter-cli/compare/v1.7.2...v1.7.3)
+
+> 16 March 2025
+
+- fix: absolute remote path treated as relative in update #10 [`cb716a3`](https://github.com/HeyPuter/puter-cli/commit/cb716a37afdd9f552c53244a3eb63d7a649e244c)
+
+#### [v1.7.2](https://github.com/HeyPuter/puter-cli/compare/v1.7.1...v1.7.2)
+
+> 4 March 2025
+
+- fix: mv command for both rename/move files [`0b944c8`](https://github.com/HeyPuter/puter-cli/commit/0b944c8295f615427bd90d19a6058b2053c1b3dc)
+
+#### [v1.7.1](https://github.com/HeyPuter/puter-cli/compare/v1.7.0...v1.7.1)
+
+> 4 March 2025
+
+- fix: update command [`38ca9e8`](https://github.com/HeyPuter/puter-cli/commit/38ca9e824642cbf8b1ffdb0d2a6e5426f84c7371)
+- docs: update README [`6e658f6`](https://github.com/HeyPuter/puter-cli/commit/6e658f6a117ee1ba206768905d53fb61c78e136d)
+
+#### [v1.7.0](https://github.com/HeyPuter/puter-cli/compare/v1.6.1...v1.7.0)
+
+> 16 February 2025
+
+- feat: save auth token when login [`55b32b7`](https://github.com/HeyPuter/puter-cli/commit/55b32b7feca050902f4470f06af38f81d3299e6a)
+- fix: create app from host shell [`30e5028`](https://github.com/HeyPuter/puter-cli/commit/30e5028d831d26349e3ae2fc8e34921693b5702c)
+
+#### [v1.6.1](https://github.com/HeyPuter/puter-cli/compare/v1.6.0...v1.6.1)
+
+> 16 February 2025
+
+- fix: set subdomain when creating a site [`6329ed1`](https://github.com/HeyPuter/puter-cli/commit/6329ed1c766b8eb722ac8c03c9ffe61dbba4a66c)
+
+#### [v1.6.0](https://github.com/HeyPuter/puter-cli/compare/v1.5.7...v1.6.0)
+
+> 16 February 2025
+
+- feat: improve init command [`2bd51ee`](https://github.com/HeyPuter/puter-cli/commit/2bd51ee01d0636b7979a9f55d3c746287c3b512a)
+- chore: improve error message [`46fb3b0`](https://github.com/HeyPuter/puter-cli/commit/46fb3b063c1c74d0006138cd400b6ad207e784d9)
+- chore: update package repo [`f6960ed`](https://github.com/HeyPuter/puter-cli/commit/f6960ed6f8e6fb793a6b8340476ab22778b44c14)
+
+#### [v1.5.7](https://github.com/HeyPuter/puter-cli/compare/v1.5.6...v1.5.7)
+
+> 16 February 2025
+
+- chore: clean unused [`8477dc2`](https://github.com/HeyPuter/puter-cli/commit/8477dc294773c99270a83dc22ae602abe92621cf)
+
+#### [v1.5.6](https://github.com/HeyPuter/puter-cli/compare/v1.5.5...v1.5.6)
+
+> 15 February 2025
+
+- fix: default api values [`146eda5`](https://github.com/HeyPuter/puter-cli/commit/146eda560da02f21a04523333b615c9ee2372322)
+
+#### [v1.5.5](https://github.com/HeyPuter/puter-cli/compare/v1.5.4...v1.5.5)
+
+> 13 February 2025
+
+- fix: improve error handling [`d1fa91d`](https://github.com/HeyPuter/puter-cli/commit/d1fa91db09f08238c6be684ffe4688a0064f06cd)
+
+#### [v1.5.4](https://github.com/HeyPuter/puter-cli/compare/v1.5.3...v1.5.4)
+
+> 13 February 2025
+
+- Remove "subdomain deletion" under Known Issues in README.md [`#8`](https://github.com/HeyPuter/puter-cli/pull/8)
+- dev: add last-error command, context, and modules [`#7`](https://github.com/HeyPuter/puter-cli/pull/7)
+- fix: delete a subdomain error message [`ed676dc`](https://github.com/HeyPuter/puter-cli/commit/ed676dc9d1364fabf242098e142a84c305dff177)
+- ci: fix timezone issue [`8ee6a66`](https://github.com/HeyPuter/puter-cli/commit/8ee6a66db36f7ca00eb81a12c8bac094e057f534)
+- ci: simplify timezone check [`ecf3bb9`](https://github.com/HeyPuter/puter-cli/commit/ecf3bb98bec5c093c23772280e3ee52aab8f3e8f)
+
+#### [v1.5.3](https://github.com/HeyPuter/puter-cli/compare/v1.5.2...v1.5.3)
+
+> 7 February 2025
+
+- refactor: early return in fallback behavior [`#6`](https://github.com/HeyPuter/puter-cli/pull/6)
+- fix: ignore undefined appDir when listing sites [`#5`](https://github.com/HeyPuter/puter-cli/pull/5)
+- fix: use array args when calling DeleteSubdomain [`#4`](https://github.com/HeyPuter/puter-cli/pull/4)
+- Update README.md [`#3`](https://github.com/HeyPuter/puter-cli/pull/3)
+- fix: improve app uuid check [`49dcc7f`](https://github.com/HeyPuter/puter-cli/commit/49dcc7f1220a58987601e8054b0d4a450cd02afe)
+- fix: potential timezone issues [`ba0e4b1`](https://github.com/HeyPuter/puter-cli/commit/ba0e4b183efb82a0c252e5c6250d976f1efe19cd)
+
+#### [v1.5.2](https://github.com/HeyPuter/puter-cli/compare/v1.5.1...v1.5.2)
+
+> 6 February 2025
+
+- chore: clean unused [`e5c7fcc`](https://github.com/HeyPuter/puter-cli/commit/e5c7fcca3096b4b2c0659d84d8de63dce039a765)
+- chore: more details [`0a25a2f`](https://github.com/HeyPuter/puter-cli/commit/0a25a2fb7efa9a67033b4e483305da44a68f2c9a)
+- docs: badge version [`503bc66`](https://github.com/HeyPuter/puter-cli/commit/503bc6667666b14f85245887a3bf2071711dc4e1)
+
+#### [v1.5.1](https://github.com/HeyPuter/puter-cli/compare/v1.5.0...v1.5.1)
+
+> 5 February 2025
+
+- imporve listing uid [`e2573f8`](https://github.com/HeyPuter/puter-cli/commit/e2573f83df6b47d8ab32ffc66ab19a9c984dd250)
+
+#### [v1.5.0](https://github.com/HeyPuter/puter-cli/compare/v1.4.4...v1.5.0)
+
+> 5 February 2025
+
+- fix: improve version check [`f3ea79e`](https://github.com/HeyPuter/puter-cli/commit/f3ea79e3156632f892558489dfd34b1119948a48)
+- update README [`79b381c`](https://github.com/HeyPuter/puter-cli/commit/79b381c57935cae5ffb9edf5ad11aca395ae8f8d)
+
+#### [v1.4.4](https://github.com/HeyPuter/puter-cli/compare/v1.4.3...v1.4.4)
+
+> 4 February 2025
+
+- simplify failed login [`bbf8a42`](https://github.com/HeyPuter/puter-cli/commit/bbf8a429c1d2a64fbb03fb42f461bcc1a32c8379)
+
+#### [v1.4.3](https://github.com/HeyPuter/puter-cli/compare/v1.4.2...v1.4.3)
+
+> 2 February 2025
+
+- fix: show disk usage [`dfd0ca3`](https://github.com/HeyPuter/puter-cli/commit/dfd0ca302f459b7295593c8d0147df15e488c963)
+
+#### [v1.4.2](https://github.com/HeyPuter/puter-cli/compare/v1.4.1...v1.4.2)
+
+> 30 January 2025
+
+- license to MIT [`ed0c7ce`](https://github.com/HeyPuter/puter-cli/commit/ed0c7cefba242a5d8fe701cddf5adbe32121bca7)
+- codecov: setup & badge [`7c4211b`](https://github.com/HeyPuter/puter-cli/commit/7c4211b6ea7b882485e3dfbaa17887a2d1fabccc)
+- changelog: update license [`dcf8d23`](https://github.com/HeyPuter/puter-cli/commit/dcf8d232160cf74d13267baa07a8f36578df9443)
+
+#### [v1.4.1](https://github.com/HeyPuter/puter-cli/compare/v1.4.0...v1.4.1)
+
+> 27 January 2025
+
+- feat: init command will scaffold new project [`c61d3f8`](https://github.com/HeyPuter/puter-cli/commit/c61d3f8669d66eb1a869db38b877d226d00b8aca)
+- changelog: update [`c09aa17`](https://github.com/HeyPuter/puter-cli/commit/c09aa179bd0ad2f437bdf779916050c2496424cd)
+
+#### [v1.4.0](https://github.com/HeyPuter/puter-cli/compare/v1.3.0...v1.4.0)
+
+> 26 January 2025
+
+- offline mode to get version [`d3c1dc2`](https://github.com/HeyPuter/puter-cli/commit/d3c1dc275bf8a1f38f083c8cdb066fb884a08138)
+- changelog: update [`f0cc1e3`](https://github.com/HeyPuter/puter-cli/commit/f0cc1e36b2b246d65a88f32c626942c0e15ac245)
+
+#### [v1.3.0](https://github.com/HeyPuter/puter-cli/compare/v1.2.1...v1.3.0)
+
+> 22 January 2025
+
+- ci: simplify workflow [`757b41c`](https://github.com/HeyPuter/puter-cli/commit/757b41caa62dc71946e7f1ffb34a32f2871248e0)
+- test: setup coverage [`2dd6500`](https://github.com/HeyPuter/puter-cli/commit/2dd650088ad9ecb6f7f9cd60b3dab80d48ac2611)
+- ci: update packages [`b346932`](https://github.com/HeyPuter/puter-cli/commit/b346932c4b6af2d8e43279ad3f35c45e451fd9f0)
+
+#### [v1.2.1](https://github.com/HeyPuter/puter-cli/compare/v1.2.0...v1.2.1)
+
+> 18 January 2025
+
+- feat: update changelog [`028ca0c`](https://github.com/HeyPuter/puter-cli/commit/028ca0cf72e09bb63468d2b0a0ba7602d3b870ad)
+- feat: auto-update changelog [`3004bed`](https://github.com/HeyPuter/puter-cli/commit/3004beda6afcf68cc916d544a45be85fa7e658e3)
+
+#### [v1.2.0](https://github.com/HeyPuter/puter-cli/compare/v1.1.5...v1.2.0)
+
+> 18 January 2025
+
+- ci: attempt to fix npm install [`32fc508`](https://github.com/HeyPuter/puter-cli/commit/32fc508c4807119de485926674274b70e034288f)
+- feat: basic history command [`18da28c`](https://github.com/HeyPuter/puter-cli/commit/18da28c83aa0760128d7b18e66e6b4d2b08b48d3)
+- chore: improve structure [`70b67ad`](https://github.com/HeyPuter/puter-cli/commit/70b67adad5bd5e0bad4a9276160d17538d9b4bb6)
+
+#### [v1.1.5](https://github.com/HeyPuter/puter-cli/compare/v1.1.4...v1.1.5)
+
+> 16 January 2025
+
+- fix: description arg handling & improve args parsing [`45c5a8c`](https://github.com/HeyPuter/puter-cli/commit/45c5a8c19034379e3cd7f30e724b8675d98bf28f)
+
+#### [v1.1.4](https://github.com/HeyPuter/puter-cli/compare/v1.1.3...v1.1.4)
+
+> 16 January 2025
+
+- improve compatibility crypto api [`b015e6f`](https://github.com/HeyPuter/puter-cli/commit/b015e6f1318a2c4994675dd7390fab09d45bf3e9)
+- fix: temporary disabled description [`c7456be`](https://github.com/HeyPuter/puter-cli/commit/c7456bed1c496f1a52156801aa4c0ea0191279c7)
+
+#### [v1.1.3](https://github.com/HeyPuter/puter-cli/compare/v1.1.2...v1.1.3)
+
+> 14 January 2025
+
+- fix: unavailable subdomain when update app [`2497de4`](https://github.com/HeyPuter/puter-cli/commit/2497de41b5691df4d3a141952841c08cace4703c)
+
+#### [v1.1.2](https://github.com/HeyPuter/puter-cli/compare/v1.1.1...v1.1.2)
+
+> 14 January 2025
+
+- grab latest version from npm [`9c32190`](https://github.com/HeyPuter/puter-cli/commit/9c321906415dfb5baa3d2bbba7b352f2766f8b84)
+
+#### [v1.1.1](https://github.com/HeyPuter/puter-cli/compare/v1.1.0...v1.1.1)
+
+> 14 January 2025
+
+- Create npm-publish action [`48d9a70`](https://github.com/HeyPuter/puter-cli/commit/48d9a709417664900681e2219ea2af5e9bf33c01)
+- update README: badges [`49241d7`](https://github.com/HeyPuter/puter-cli/commit/49241d7144c8c128955891a64acb448e79e1822c)
+
+#### [v1.1.0](https://github.com/HeyPuter/puter-cli/compare/v1.0.3...v1.1.0)
+
+> 14 January 2025
+
+- feat: add support for 2FA logins [`#1`](https://github.com/HeyPuter/puter-cli/pull/1)
+
+#### [v1.0.3](https://github.com/HeyPuter/puter-cli/compare/v1.0.1...v1.0.3)
+
+> 13 January 2025
+
+- update README [`479b8fc`](https://github.com/HeyPuter/puter-cli/commit/479b8fc9c784061146f453bc68759dbdb417ea1e)
+
+#### v1.0.1
+
+> 13 January 2025
+
+- initial commit [`604d4a4`](https://github.com/HeyPuter/puter-cli/commit/604d4a47c8b593b7e24757c115df728f09233664)
+- output nicely formatted table [`a0adb75`](https://github.com/HeyPuter/puter-cli/commit/a0adb75813bcecb21878c8ae7228b0ecbfdb397f)
+- remove unused packages [`925b6cb`](https://github.com/HeyPuter/puter-cli/commit/925b6cbf827e619e65eb5afaa566a4d14e919cb8)

package/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Ibrahim H.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,18 @@
+# puter-sh
+
+SSH-style shell access to your Puter files. Connect to your Puter account and browse, read, and manage your files from the terminal.
+
+> **Looking to deploy sites or manage apps?** You want [`@heyputer/cli`](https://www.npmjs.com/package/@heyputer/cli).
+
+## Install
+
+    npm install -g @heyputer/shell
+
+## Usage
+
+    puter-sh          # start an interactive session
+    psh               # short alias
+
+---
+
+*Previously published as `puter-cli`. If you have the old package installed: `npm uninstall -g puter-cli`.*