JSPM – fella-cli@1.0.1

Package Exports

fella-cli
fella-cli/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (fella-cli) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

◆ File Exploration and Local Logic Automation ◆
An Agentic CLI for Windows - talk to your file system through prompts.

What can FELLA do?

Just type what you want — no commands to memorise.

organise my downloads by file type
move report.pdf from downloads to documents
create a folder on the desktop called Projects
open notepad
delete old notes from desktop
undo

FELLA understands you, executes the action, and shows you the result — all inside the terminal.

Getting Started

Option 1 — Download the .exe (no Node.js required)

Go to the Releases page and download fella-win.exe
Double-click it, or run it from any terminal:

fella-win.exe

First launch may show a Windows SmartScreen prompt — click More info → Run anyway.

Option 2 — Install via npm

Requires Node.js 18+.

npm install -g fella-cli
fella

No API keys or config files needed — everything is bundled.

When you first open FELLA, it will ask how you want to sign in. Just type one of:

What you type	What it does
`signup`	Create a new account with email & password
`login`	Sign in with your email & password
`google`	Sign in with Google (opens your browser)

After signing in, FELLA launches automatically.

fella logout      # sign out
fella whoami      # see who you're logged in as

What you can ask

Files & Folders

list my downloads
list files in D:\Projects

create a folder called MyWork on the desktop
move budget.xlsx from desktop to documents
rename D:\Projects\old to D:\Projects\new
delete notes.txt from desktop

Organise files

organise my downloads by file type
organise downloads from last week by category
organise D:\Archive by date

FELLA always shows a preview first — nothing moves until you confirm with yes.

Sort by: type · category · date · size · extension
Filter by: last_week · last_month · last_3_months · last_year

Undo anything

undo
redo

Every file action is fully reversible for the lifetime of your session.

Launch apps

open notepad
launch chrome
start visual studio code
open calculator

Screen automation

take a screenshot
click on the Save button
type Hello World
press ctrl+s
scroll down
find the text "OK" on screen

Keyboard shortcuts

Key	Action
`Enter`	Send message
`↑` / `↓`	Browse previous commands
`Ctrl + L`	Clear conversation
`Ctrl + C`	Exit

Folder shortcuts

You can use friendly names instead of full paths:

desktop · documents · downloads · pictures · music · videos · temp · appdata · d:

Troubleshooting

SmartScreen blocks the .exe Click More info → Run anyway. This happens because the binary isn't code-signed yet.

Organise shows "No files found" Your folder may be empty, or the time filter is too narrow. Try without a filter: organise downloads by type

Undo says "folder is not empty" Add files were added to the folder after it was created. Empty it first, then undo.

Screen clicks / OCR not working App launching and folder navigation always work. Advanced screen features (click, OCR, screenshot) require the native nut-js addon to be present alongside the binary.

fella-cli