@chosengeneration/fire-code 0.6.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Light Code contributors
+
+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,88 @@
+# Fire Code
+
+Every codebase you work on, in one Windows window — each with its own
+[Light Code](https://github.com/chosengenerationdev/light-code) agent, all working at the same time.
+
+- **A sidebar of codebases.** Add any folder on your machine. Switch with a click, `Ctrl+1…9`, or
+  `Ctrl+K` and a few letters. Hide the sidebar with `Ctrl+B` for more room; a slim strip keeps
+  every agent's status in view.
+- **Agents keep working in the background.** Each codebase runs in its own process, so a long task
+  in one never slows another, and switching away pauses nothing.
+- **Your existing settings.** Point a codebase at the Light Code config it already has — the VS Code
+  extension's, or the Node host's that IntelliJ and PyCharm use — and its providers, MCP servers,
+  search connections and project settings apply in place. Or copy one, or start fresh.
+- **Windows notifications** when a background agent finishes, needs your approval, or sends one
+  with `notify` — including scheduled runs. Click one to jump to that chat.
+- **See who is waiting for you**: a "!" on any codebase whose agent needs your approval, an answer or a form.
+- **Refer to other codebases**: `@payments-api:src/app.py`, or just `@` and pick one; every agent knows the others.
+- **Git changes at a glance**: +new ~modified −deleted on each codebase that git manages.
+- **Schedules run on time even for sleeping codebases**: Fire Code wakes a codebase just before its job is due
+  and lets it sleep again afterwards.
+- **Idle codebases sleep** after a while to give memory back (never while working, waiting for you,
+  or holding schedules), and wake in a moment when clicked.
+- **Reach beyond the codebase**: agents read any drive or shared folder, and may write anywhere — asking
+  you every time they write outside the codebase. Keys, passwords and Windows folders stay off-limits.
+- **Fast, parallel file tools** written in Rust: find files across whole drives and shares, summarise a
+  folder, spot duplicates, read many files at once, and work through huge logs and CSV or Excel files
+  part by part — search, read any window, filter, group and total millions of rows in about a second.
+- **Copy, move and zip** whole folders on every core — always asking first, with exactly what will be
+  copied, moved, replaced or extracted.
+- **Several chats per codebase**, each its own agent, safe to run side by side.
+- **Reports in Fire Code**: Markdown and HTML reports from scheduled runs open in Fire Code's own viewer.
+- **One environment for every agent**: a startup script (.cmd, .bat or .ps1), folders to put on PATH,
+  and variables — plain values or saved credentials.
+- **Everything Light Code does**: the same tools, MCP, Python tools, skills, Excel and Outlook,
+  Confluence, Jira, Bitbucket, Jenkins, AutoSys, search and schedules — it is the same agent.
+
+## Install
+
+```
+npm i -g @chosengeneration/fire-code
+fire-code
+```
+
+Used **Sun Code** or **Sun Light Code** before? Fire Code is its new name. Your codebases, chats and credentials move
+across by themselves the first time Fire Code starts; then remove the old package with
+`npm uninstall -g @chosengeneration/sun-light-code`.
+
+Windows 10 or 11 (x64) and Node.js 18 or newer. The package is prebuilt: it has **no install
+scripts and no dependencies**, so installing only copies files — nothing is compiled and nothing is
+downloaded, which is what makes it install cleanly on a locked-down office machine. The window uses
+Microsoft Edge WebView2, which comes with Windows 11 (and with Edge on Windows 10).
+
+## Settings and keys
+
+When you add a codebase you choose where its Light Code settings come from:
+
+| Choice | What happens |
+|---|---|
+| **Link** | Uses an existing `config.json` in place. Changes made in Fire Code or in the other app reach both. |
+| **Copy** | Takes a copy now; independent afterwards. |
+| **New** | Empty settings, set up in that codebase's Settings. |
+
+A folder's own `.lightcode/config.json` is always used, whichever you choose.
+
+**API keys and passwords are not in config files.** The VS Code extension keeps them in VS Code's
+encrypted storage, which another program cannot read, so enter each once in Fire Code — it then shares
+them with every codebase. Fire Code keeps them in `%LOCALAPPDATA%\fire-code\secrets.json`, readable
+by your Windows account only, not in an OS keychain; it says so rather than implying otherwise.
+
+## What it connects to
+
+Nothing on its own. Like Light Code, Fire Code has no telemetry, no update checks and no default
+endpoints: the only hosts contacted are the ones you configure. Each codebase's agent runs on
+`127.0.0.1` behind a one-time token, and is stopped — with every process it started — when Fire Code
+closes.
+
+## Theme
+
+Settings (`Ctrl+,`) chooses light, dark or system and an accent colour. Every chat follows them,
+and so do the window and taskbar icons; each chat keeps its own role colours.
+
+## Building it
+
+The source is in [`apps/sun`](https://github.com/chosengenerationdev/light-code/tree/main/apps/sun)
+of the Light Code repository, and Fire Code's Settings can export the whole repository as a zip that
+builds offline. You need Rust 1.86+ (MSVC) and pnpm; then `node apps/sun/scripts/build.mjs`.
+
+MIT licensed.

package/bin/fire-code.cjs

@@ -0,0 +1,61 @@
+#!/usr/bin/env node
+'use strict'
+/*
+ * `fire-code` - opens the Fire Code window and gives the terminal back.
+ *
+ * The window is a prebuilt exe in this package; there is nothing to compile and nothing was
+ * downloaded at install (the package has no install scripts and no dependencies). This launcher
+ * only tells it which Node to run each codebase's agent with - the one npm installed it with - and
+ * where the bundled Light Code host is.
+ */
+const { spawn } = require('node:child_process')
+const fs = require('node:fs')
+const path = require('node:path')
+
+const root = path.join(__dirname, '..')
+const version = JSON.parse(fs.readFileSync(path.join(root, 'package.json'), 'utf8')).version
+const args = process.argv.slice(2)
+
+if (args.includes('--version') || args.includes('-v')) {
+  process.stdout.write(`${version}\n`)
+  process.exit(0)
+}
+if (args.includes('--help') || args.includes('-h')) {
+  process.stdout.write(`fire-code ${version}
+
+Opens Fire Code: every codebase in one window, each with its own Light Code agent.
+If it is already open, brings that window forward.
+
+  --version, -v   Print the version
+  --help, -h      This text
+
+Data lives in %LOCALAPPDATA%\\fire-code (set FIRE_CODE_HOME to move it).
+`)
+  process.exit(0)
+}
+if (process.platform !== 'win32') {
+  process.stderr.write('Fire Code is a Windows application. On this system, use the Light Code Node host: npx @chosengeneration/light-code\n')
+  process.exit(1)
+}
+
+const dist = path.join(root, 'dist')
+const exe = path.join(dist, 'fire-code.exe')
+if (!fs.existsSync(exe)) {
+  process.stderr.write(`fire-code: ${exe} is missing. Reinstall with: npm i -g @chosengeneration/fire-code\n`)
+  process.exit(1)
+}
+
+const child = spawn(exe, [], {
+  detached: true,
+  stdio: 'ignore',
+  env: {
+    ...process.env,
+    FIRE_CODE_NODE: process.execPath,
+    FIRE_CODE_HOST: path.join(dist, 'host', 'light-code.cjs'),
+  },
+})
+child.on('error', (error) => {
+  process.stderr.write(`fire-code: could not start ${exe}: ${error.message}\n`)
+  process.exit(1)
+})
+child.unref()