firefly-cli: add version 0.1.0

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

4 files changed, 125 insertions, 0 deletions

diff --git a/firefly-cli/README b/firefly-cli/README
new file mode 100644
index 0000000..b4da0e8
--- /dev/null
+++ b/firefly-cli/README
@@ -0,0 +1,15 @@
+firefly-cli is a command-line tool that lets an LLM agent (and you)
+interact with a self-hosted Firefly III instance over its REST API. It
+exposes the 'firefly' command, emits JSON by default (pass --human for
+tables), and resolves account, category, and tag names to IDs.
+
+Pure Python, standard library only. No third-party runtime dependencies.
+Requires Python 3.11 or newer.
+
+Configuration: provide your Firefly III URL and a personal access token
+either by running 'firefly auth set' (stored in a local TOML file) or by
+setting the FIREFLY_URL and FIREFLY_TOKEN environment variables, which
+take precedence over the config file.
+
+A Firefly III instance and a valid personal access token are required at
+runtime; they are not build-time dependencies.
diff --git a/firefly-cli/firefly-cli.SlackBuild b/firefly-cli/firefly-cli.SlackBuild
new file mode 100644
index 0000000..c58a9f7
--- /dev/null
+++ b/firefly-cli/firefly-cli.SlackBuild
@@ -0,0 +1,81 @@
+#!/bin/bash
+
+# Slackware build script for firefly-cli
+
+# Copyright 2026 danix <danix@danix.xyz>
+# All rights reserved.
+#
+# Redistribution and use of this script, with or without modification, is
+# permitted provided that the following conditions are met:
+#
+# 1. Redistributions of this script must retain the above copyright
+#    notice, this list of conditions and the following disclaimer.
+#
+#  THIS SOFTWARE IS PROVIDED BY THE AUTHOR "AS IS" AND ANY EXPRESS OR IMPLIED
+#  WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
+#  MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO
+#  EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+#  SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+#  PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
+#  OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
+#  WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+#  OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
+#  ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+cd $(dirname $0) ; CWD=$(pwd)
+
+PRGNAM=firefly-cli
+VERSION=${VERSION:-0.1.0}
+BUILD=${BUILD:-1}
+TAG=${TAG:-_SBo}
+PKGTYPE=${PKGTYPE:-tgz}
+
+if [ -z "$ARCH" ]; then
+  case "$( uname -m )" in
+    i?86) ARCH=i586 ;;
+    arm*) ARCH=arm ;;
+       *) ARCH=$( uname -m ) ;;
+  esac
+fi
+
+if [ ! -z "${PRINT_PACKAGE_NAME}" ]; then
+  echo "$PRGNAM-$VERSION-$ARCH-$BUILD$TAG.$PKGTYPE"
+  exit 0
+fi
+
+TMP=${TMP:-/tmp/SBo}
+PKG=$TMP/package-$PRGNAM
+OUTPUT=${OUTPUT:-/tmp}
+
+# Pure-Python (noarch); set ARCH=noarch for the package name.
+ARCH=noarch
+
+set -e
+
+rm -rf $PKG
+mkdir -p $TMP $PKG $OUTPUT
+cd $TMP
+rm -rf $PRGNAM-$VERSION
+tar xvf $CWD/$PRGNAM-$VERSION.tar.gz
+cd $PRGNAM-$VERSION
+chown -R root:root .
+find -L . \
+ \( -perm 777 -o -perm 775 -o -perm 750 -o -perm 711 -o -perm 555 \
+  -o -perm 511 \) -exec chmod 755 {} \; -o \
+ \( -perm 666 -o -perm 664 -o -perm 640 -o -perm 600 -o -perm 444 \
+  -o -perm 440 -o -perm 400 \) -exec chmod 644 {} \;
+
+python3 -m build --wheel --no-isolation
+python3 -m installer --destdir "$PKG" dist/*.whl
+
+mkdir -p $PKG/usr/doc/$PRGNAM-$VERSION
+cp -a \
+  LICENSE README.md SKILL.md \
+  $PKG/usr/doc/$PRGNAM-$VERSION
+cat $CWD/$PRGNAM.SlackBuild > $PKG/usr/doc/$PRGNAM-$VERSION/$PRGNAM.SlackBuild
+
+mkdir -p $PKG/install
+cat $CWD/slack-desc > $PKG/install/slack-desc
+
+cd $PKG
+/sbin/makepkg -l y -c n $OUTPUT/$PRGNAM-$VERSION-$ARCH-$BUILD$TAG.$PKGTYPE
diff --git a/firefly-cli/firefly-cli.info b/firefly-cli/firefly-cli.info
new file mode 100644
index 0000000..f237090
--- /dev/null
+++ b/firefly-cli/firefly-cli.info
@@ -0,0 +1,10 @@
+PRGNAM="firefly-cli"
+VERSION="0.1.0"
+HOMEPAGE="https://git.danix.xyz/firefly-cli/"
+DOWNLOAD="https://github.com/danixland/firefly-cli/archive/v0.1.0/firefly-cli-0.1.0.tar.gz"
+MD5SUM="98abd3f781cab671184e014af179788d"
+DOWNLOAD_x86_64=""
+MD5SUM_x86_64=""
+REQUIRES=""
+MAINTAINER="danix"
+EMAIL="danix@danix.xyz"
diff --git a/firefly-cli/slack-desc b/firefly-cli/slack-desc
new file mode 100644
index 0000000..012abeb
--- /dev/null
+++ b/firefly-cli/slack-desc
@@ -0,0 +1,19 @@
+# HOW TO EDIT THIS FILE:
+# The "handy ruler" below makes it easier to edit a package description.
+# Line up the first '|' above the ':' following the base package name, and
+# the '|' on the right side marks the last column you can put a character in.
+# You must make exactly 11 lines for the formatting to be correct.  It's also
+# customary to leave one space after the ':' except on otherwise blank lines.
+
+           |-----handy-ruler------------------------------------------------------|
+firefly-cli: firefly-cli (CLI for agent interaction with Firefly III)
+firefly-cli:
+firefly-cli: A command-line tool that lets an LLM agent (and you) interact with
+firefly-cli: a Firefly III instance over its REST API. It exposes the 'firefly'
+firefly-cli: command, emits JSON by default, and resolves account, category, and
+firefly-cli: tag names to IDs. Pure Python, standard library only, no third-party
+firefly-cli: runtime dependencies.
+firefly-cli:
+firefly-cli: Homepage: https://git.danix.xyz/firefly-cli/
+firefly-cli:
+firefly-cli: