@arcforge/axon 0.7.2

package/LICENSE

@@ -0,0 +1,26 @@
+Copyright (c) 2025 ArcForge
+
+All rights reserved.
+
+This software and associated documentation files (the "Software") are proprietary
+and confidential to ArcForge.
+
+The Software is licensed, not sold. This license grants you the following rights:
+
+1. You may install and use the Software solely for your internal business purposes.
+
+2. You may not:
+   - Modify, adapt, translate, or create derivative works of the Software
+   - Reverse engineer, decompile, or disassemble the Software
+   - Remove or alter any proprietary notices or labels on the Software
+   - Distribute, sublicense, lease, rent, loan, or transfer the Software to any third party
+   - Use the Software for any purpose other than as expressly permitted herein
+
+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
+ARCFORGE 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.
+
+For licensing inquiries, please contact: legal@arcforge.io

package/README.md

@@ -0,0 +1,52 @@
+# Axon
+
+> High-performance CLI coding agent with Blessed terminal UI
+
+Axon is a powerful terminal-based coding agent that combines LLM capabilities with a beautiful text-based user interface.
+
+## Installation
+
+```bash
+npm install -g @arcforge/axon
+```
+
+**Requirements:**
+- [Bun](https://bun.sh) runtime installed
+
+## Quick Start
+
+```bash
+axon
+```
+
+This launches the interactive terminal UI where you can:
+- Chat with the AI coding agent
+- Manage multiple processes
+- View and manage tasks in a Kanban board
+- Customize themes and audio visualizations
+
+## Features
+
+- **🎨 Beautiful Terminal UI** - Built with Blessed for a responsive TUI experience
+- **🤖 AI-Powered** - Integrated LLM agent for coding assistance
+- **📋 Process Management** - Monitor and control running processes
+- **🎯 Task Management** - Built-in Kanban board for organizing work
+- **🎵 Audio Visualizer** - Real-time audio visualization in your terminal
+- **🔐 Device Authentication** - Secure authentication flow
+- **⚡ High Performance** - Built with Bun for speed
+
+## Usage
+
+Once launched, use keyboard shortcuts to navigate:
+- Arrow keys to navigate menus
+- Enter to select
+- Esc to go back
+- Tab to switch between panels
+
+Visit the in-app profile page for more keyboard shortcuts and settings.
+
+## License
+
+Copyright © 2025 ArcForge. All rights reserved.
+
+This is proprietary software. Unauthorized copying, modification, distribution, or use of this software is strictly prohibited.

package/app/index.ts

@@ -0,0 +1,204 @@
+import blessed from "blessed"
+
+import {
+    useAudioVisualizer,
+    useScreen,
+    useCommands,
+    useCognos,
+    useStack,
+    useRouter,
+    useDeviceAuth,
+} from "#composables"
+
+import {
+    ChatPage,
+    KanbanPage,
+    LoginPage,
+    ProcessesPage,
+    ProcessDetailPage,
+    ProfilePage,
+    ThemePage,
+} from "#pages"
+import { builtinCommands, processCommands, kanbanCommands, parseArgs, printHelp, executePrompt, redirectConsoleToFile, restoreConsole, getLogFilePath } from "#lib"
+import { Footer } from "#components"
+
+
+/**
+ * Interactive mode: Full blessed TUI
+ *
+ * The screen consists of two regions:
+ *
+ * - The current page (chat, login, etc.), containing page-specific content.
+ * - The footer, containing chat input and menus.
+ *
+ */
+async function mainInteractive(debug: boolean = false) {
+    // Redirect console output to prevent TUI corruption (unless debug mode)
+    if (!debug) {
+        redirectConsoleToFile()
+    }
+
+    const screen = useScreen()
+    const commands = useCommands()
+    const stackComposable = useStack()
+    const cognos = useCognos()
+    const router = useRouter()
+    const deviceAuth = useDeviceAuth()
+
+    // Register builtin commands
+    builtinCommands.forEach(cmd => commands.register(cmd))
+
+    // Register process management commands
+    processCommands.forEach(cmd => commands.register(cmd))
+
+    // Register kanban commands
+    kanbanCommands.forEach(cmd => commands.register(cmd))
+
+
+    // Navigate to chat immediately if at root
+    if (router.current().path === "/") {
+        router.navigate("/chat")
+    }
+
+    // Start auth check in background (non-blocking)
+    // The result will be awaited later when the user sends their first message
+    deviceAuth.checkAuth().then(isAuthenticated => {
+        if (isAuthenticated) {
+            // Only connect to websocket after successful auth
+            cognos.connect().catch(error => {
+                console.error("Failed to connect to websocket:", error)
+            })
+        } else if (router.current().path !== "/login") {
+            // Redirect to login if auth fails
+            router.navigate("/login")
+        }
+    })
+
+    const container = blessed.box({
+        width: "100%",
+        height: "100%",
+        layout: "vertical",
+    })
+
+    const footer = Footer()
+
+    // Create page mapping with route patterns
+    const routes = [
+        { pattern: "/login", component: () => LoginPage() },
+        { pattern: "/chat", component: () => ChatPage() },
+        { pattern: "/kanban", component: () => KanbanPage() },
+        { pattern: "/processes", component: () => ProcessesPage() },
+        { pattern: "/processes/:refId", component: () => ProcessDetailPage() },
+        { pattern: "/profile", component: () => ProfilePage() },
+        { pattern: "/theme", component: () => ThemePage() },
+    ]
+
+    // Helper to find matching route
+    function findMatchingRoute(path: string) {
+        for (const route of routes) {
+            const match = router.match(route.pattern)
+            if (match) {
+                return route
+            }
+        }
+        // Default to login if no match
+        return routes[0]
+    }
+
+    // Initialize with the current page
+    const initialRoute = findMatchingRoute(router.current().path)
+    let currentPageNode = initialRoute.component().node
+
+    container.append(footer.node)
+    container.append(currentPageNode)
+
+    screen.append(container)
+    screen.append(footer.paletteNode) // Append command palette to screen so it floats above footer
+    screen.append(footer.pagePaletteNode) // Append page palette to screen so it floats above footer
+    screen.render()
+
+    // Focus the input initially
+    footer.focus()
+
+    // Handle page navigation
+    router.onNavigate((route) => {
+        // Remove current page
+        container.remove(currentPageNode)
+
+        // Find matching route and create page
+        const matchedRoute = findMatchingRoute(route.path)
+        currentPageNode = matchedRoute.component().node
+        container.append(currentPageNode)
+
+        // Keep footer on top
+        container.remove(footer.node)
+        container.append(footer.node)
+
+        screen.render()
+    })
+
+    // Initialize audio visualizer (will activate in voice mode)
+    const audioVisualizer = useAudioVisualizer()
+    audioVisualizer.init()
+
+    // Show Axon logo and stats on boot
+    const axonCmd = builtinCommands.find(cmd => cmd.name === "axon")
+    if (axonCmd) {
+        axonCmd.execute()
+    }
+
+    stackComposable.onUpdate(() => {
+        // Put the footer back at the top (z-index).
+        container.remove(footer.node)
+        container.append(footer.node)
+        screen.render()
+    })
+
+    // Setup cleanup handlers for websocket and capsule
+    const cleanup = async () => {
+        cognos.disconnect()
+        if (!debug) {
+            restoreConsole()
+        }
+    }
+
+    process.on("SIGINT", async () => {
+        await cleanup()
+        process.exit(0)
+    })
+
+    process.on("exit", async () => {
+        await cleanup()
+    })
+
+    screen.key(["C-c"], async () => {
+        await cleanup()
+        process.exit(0)
+    })
+}
+
+/**
+ * Main entry point: Parse args and route to appropriate mode
+ */
+async function main() {
+    const args = parseArgs(process.argv.slice(2))
+
+    if (args.help) {
+        printHelp()
+        process.exit(0)
+    }
+
+    if (args.mode === 'prompt') {
+        if (!args.prompt) {
+            console.error("Error: --prompt requires a value")
+            process.exit(1)
+        }
+        await executePrompt(args.prompt)
+        process.exit(0)
+    }
+
+    // Interactive mode (default)
+    await mainInteractive(args.debug || false)
+}
+
+await main()