StarSiftaccount

Command line

Two small programs run StarSift's engines without the window, for scripts, for checking a night from a terminal, and for AI agents. They are built from the source and are not in the downloads. No command runs a workflow: the workflows, with their denoise, star removal and stretch, run only in the app.

StarSift.Cli: look at frames

Reads FITS and XISF files, opens no window and changes nothing unless you ask for a file to be written.

Command What it does
StarSift.Cli <files or folders> [--json out.json] Scores each frame as Review does: stars, star size (FWHM), eccentricity, cloud glow, altitude, and a verdict with its reasons. Subfolders are not searched.
StarSift.Cli sort <folders> [--all] [--json out.json] What New picture makes of the folders: each file's kind (light, dark, flat, bias, master) and why, then the groups by camera, exposure, gain and filter.
StarSift.Cli plan <folders> [--solve [starsolve.ssdb]] Goes on to the targets, their sets of lights, the masters each takes and to make, and notes. --solve names targets nothing else names, with the plate solver.
StarSift.Cli addon new\|types\|check\|test\|run … Writes, checks and tests an add-on, and runs one of its steps or kernels on FITS files, with --out file.fits to save the result. See Settings and account for add-ons.
StarSift.Cli mcp A read-only Model Context Protocol server, so an AI agent can score, sort and plan frames and read headers. It cannot stack, run add-ons, or move, reject or delete a frame.

GpuStacker.Cli: stack to a FITS file

Needs a GPU. It writes a linear, unstretched 32-bit FITS file; the app's local normalization, rejection choices, previews and everything after the stack are not part of it.

Command What it does
GpuStacker.Cli stack <out.fits> <frames…> Calibrates, aligns and stacks the frames you list.
GpuStacker.Cli stack-dir <folder> [--filter L\|R\|G\|B\|ALL] [--out-dir dir] [--max-frames N] Stacks the .fit and .fits files of one folder (not its subfolders), one stack per filter in the FILTER header, to stacked_<object>_<filter>_<frames>x<exposure>s.fits.

Both take --dark, --bias, --flat and --dark-flat, each one FITS file used for every frame; masters are not chosen by exposure or filter here. Frames are stacked with winsorized sigma clipping.

From a folder to a picture

There is no single command for it. The nearest is to check with plan, stack with stack-dir, and then stretch and finish in the editor, or run an add-on step on the stack with addon run. For a finished picture straight from the folders, use New picture.

The app's options

StarSift --night starts in night vision. StarSift --software-rendering (or DEEPSKYLOG_SOFTWARE_RENDERING=1) draws without the graphics card, for a driver that shows a black window. Frames given on the command line open in the window that is already running.