loclaude 0.0.2 → 0.0.4

package/CHANGELOG.md

@@ -7,6 +7,31 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.0.4] - 2025-01-22
+
+### Changed
+
+- Updates README.md
+
+## [0.0.3] - 2025-01-22
+
+### Added
+
+- Added docs links to README.md
+
+### Changed
+
+- Removes `libs` from `package.json#files` array
+- Changes publish tag from `alpha` to `latest`
+- Running `loclaude` with no commands now prints the help message.
+
+## [0.0.2] - 2025-01-22
+
+### Changed
+
+- Adds Ollama Version check (>= 0.14.2) to `doctor` command
+- Pins to version v0.0.2 of `@loclaude-internal/cli`
+
 ## [0.0.1-alpha.3] - 2025-01-21
 
 ### Added

package/README.md

@@ -2,6 +2,8 @@
 
 # loclaude
 
+Read the [docs](https://nicholasgalante1997.github.io/loclaude/#/)
+
 **Claude Code with Local LLMs**
 
 Stop burning through Claude API usage limits. Run Claude Code's powerful agentic workflow with local Ollama models on your own hardware.
@@ -290,12 +292,6 @@ Yes! Once you have models downloaded, you can run as many sessions as you want w
 
 No, but highly recommended. CPU-only mode works with smaller models at ~10-20 tokens/sec. A GPU (16GB+ VRAM) gives you 50-100 tokens/sec with larger, better models.
 
-### What's the catch?
-
-- Initial setup takes 5-10 minutes
-- Model downloads are large (4-20GB)
-- GPU hardware investment if you don't have one (~$500-1500 used)
-
 ### Can I use this with the Claude API too?
 
 Absolutely! Keep using Claude API for critical tasks, use loclaude for everything else to save money and avoid limits.
@@ -354,32 +350,6 @@ If inference is slow on CPU:
 2. Expect ~10-20 tokens/sec on modern CPUs
 3. Consider cloud models via Ollama: `glm-4.7:cloud`
 
-## Contributing
-
-loclaude is open source and welcomes contributions! Here's how you can help:
-
-### Share Your Experience
-
-- Star the repo if loclaude saves you money or rate limits
-- Share your setup and model recommendations
-- Write about your experience on dev.to, Twitter, or your blog
-- Report bugs and request features via GitHub Issues
-
-### Code Contributions
-
-- Fix bugs or add features (see open issues)
-- Improve documentation or examples
-- Add support for new model providers
-- Optimize model loading and performance
-
-### Spread the Word
-
-- Post on r/LocalLLaMA, r/selfhosted, r/ClaudeAI
-- Share in Discord/Slack dev communities
-- Help others troubleshoot in GitHub Discussions
-
-Every star, issue report, and shared experience helps more developers discover unlimited local Claude Code.
-
 ## Getting Help
 
 - **Issues/Bugs**: [GitHub Issues](https://github.com/nicholasgalante1997/loclaude/issues)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "loclaude",
-  "version": "0.0.2",
+  "version": "0.0.4",
   "description": "Claude Code with local Ollama LLMs - Zero API costs, no rate limits, complete privacy",
   "type": "module",
   "license": "./LICENSE",
@@ -41,15 +41,13 @@
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org/",
-    "tag": "alpha"
+    "tag": "latest"
   },
   "files": [
     ".claude/CLAUDE.md",
     "bin",
     "dist",
     "docker/docker-compose.yml",
-    "libs/cli/package.json",
-    "libs/cli/dist",
     "README.md",
     "CHANGELOG.md",
     "LICENSE"
@@ -73,13 +71,15 @@
     "test": "bun test libs/cli",
     "prerelease-check": "./scripts/prerelease-check.sh",
     "prepublishOnly": "bun run build",
-    "release": "bun run build && npm publish --access public",
-    "release:rc": "bun run build && npm publish --tag rc --access public",
-    "release:alpha": "bun run build && npm publish --tag alpha --access public",
-    "release:beta": "bun run build && npm publish --tag beta --access public"
+    "prerelease": "run-s test build prerelease-check",
+    "release": "npm publish --access public",
+    "release:rc": "npm publish --tag rc --access public",
+    "release:alpha": "npm publish --tag alpha --access public",
+    "release:beta": "npm publish --tag beta --access public",
+    "postrelease": "export LOCLAUDE_RELEASE_VERSION=$(jq -r .version package.json) ./scripts/commit.sh $LOCLAUDE_RELEASE_VERSION && ./scripts/tag.sh $LOCLAUDE_RELEASE_VERSION"
   },
   "dependencies": {
-    "@loclaude-internal/cli": "^0.0.2"
+    "@loclaude-internal/cli": "^0.0.3"
   },
   "peerDependencies": {
     "typescript": "^5"
@@ -97,6 +97,7 @@
     "eslint": "^9.39.2",
     "globals": "^17.0.0",
     "jiti": "^2.6.1",
+    "npm-run-all": "^4.1.5",
     "prettier": "^3.8.0",
     "turbo": "^2.7.5",
     "typescript-eslint": "^8.53.1"

package/libs/cli/CHANGELOG.md

@@ -1,59 +0,0 @@
-# Changelog
-
-All notable changes to this project will be documented in this file.
-
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
-and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
-
-## [Unreleased]
-
-## [0.0.1-alpha.2] - 2025-01-20
-
-### Added
-
-- Adds support for CPU Only Ollama Hosts
-
-### Changed
-
-- Modifies documentation on output files from `init` command
-
-## [0.0.1-alpha.1] - 2025-01-19
-
-### Added
-
-- **CLI Commands**
-  - `loclaude run` - Run Claude Code with local Ollama (interactive model selection)
-  - `loclaude init` - Scaffold docker-compose.yml, config, and mise.toml
-  - `loclaude doctor` - Check system prerequisites (Docker, GPU, Claude CLI)
-  - `loclaude config` / `loclaude config-paths` - View configuration
-  - `loclaude docker-up/down/status/logs/restart` - Docker container management
-  - `loclaude models` - List installed Ollama models
-  - `loclaude models-pull/rm/show/run` - Model management commands
-
-- **Configuration System**
-  - Project-local config: `./.loclaude/config.json`
-  - User global config: `~/.config/loclaude/config.json`
-  - Environment variable support (`OLLAMA_URL`, `OLLAMA_MODEL`, etc.)
-  - Layered config merging with clear priority
-
-- **Cross-Runtime Support**
-  - Works with both Bun and Node.js runtimes
-  - Dual entry points: `bin/index.ts` (Bun) and `bin/index.mjs` (Node)
-
-- **Docker Integration**
-  - Bundled docker-compose.yml template with Ollama + Open WebUI
-  - NVIDIA GPU support out of the box
-  - Health checks for both services
-
-- **Project Scaffolding**
-  - `loclaude init` creates complete project structure
-  - Generates mise.toml with task aliases
-  - Creates .claude/CLAUDE.md for Claude Code instructions
-  - Sets up .gitignore for model directory
-
-### Notes
-
-This is an alpha release. The API and command structure may change before 1.0.
-
-[Unreleased]: https://github.com/nicholasgalante1997/loclaude/compare/v0.0.1-rc.1...HEAD
-[0.0.1-alpha.1]: https://github.com/nicholasgalante1997/loclaude/releases/tag/v0.0.1-alpha.1

package/libs/cli/LICENSE

@@ -1,31 +0,0 @@
-MIT License
-
-Copyright (c) 2026 Mega Blastoise
-
-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.
-
----
-
-Addendum, January 19, 2026
-
-This package leverages the [Bun](bun.sh) shell to run shell commands on behalf of the end user.  
-
-In an ideal world, I don't have to write this addendum. In this world, I do.  
-
-If you pass unsanitized input into this command line tool, all bets are off. I'll make no guarantees on your behalf about behavior or safety. I'll personally never talk to you in real life. May god have mercy on your soul.

package/libs/cli/README.md

@@ -1,5 +0,0 @@
-# @loclaude-internal/cli
-
-Internal modules for usage with [`loclaude`](https://www.npmjs.com/package/loclaude). Do not use directly.
-
-This package is not intended for public use and may change without notice.

package/libs/cli/dist/cac.d.ts

@@ -1,6 +0,0 @@
-declare const cli: import("cac").CAC;
-export declare const help: () => void;
-export declare const version: () => void;
-export declare const run_cli: () => void;
-export { cli };
-//# sourceMappingURL=cac.d.ts.map

package/libs/cli/dist/cac.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cac.d.ts","sourceRoot":"","sources":["../lib/cac.ts"],"names":[],"mappings":"AAqBA,QAAA,MAAM,GAAG,mBAAkB,CAAC;AAsI5B,eAAO,MAAM,IAAI,YAAyB,CAAC;AAC3C,eAAO,MAAM,OAAO,YAA4B,CAAC;AAEjD,eAAO,MAAM,OAAO,QAAO,IAE1B,CAAC;AAEF,OAAO,EAAE,GAAG,EAAE,CAAC"}

package/libs/cli/dist/commands/config.d.ts

@@ -1,6 +0,0 @@
-/**
- * config command - Show and manage configuration
- */
-export declare function configShow(): Promise<void>;
-export declare function configPaths(): Promise<void>;
-//# sourceMappingURL=config.d.ts.map

package/libs/cli/dist/commands/config.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../lib/commands/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,wBAAsB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAmChD;AAED,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CA6BjD"}

package/libs/cli/dist/commands/docker.d.ts

@@ -1,17 +0,0 @@
-/**
- * docker command - Manage Docker containers
- */
-export interface DockerOptions {
-    file?: string;
-    detach?: boolean;
-}
-export declare function dockerUp(options?: DockerOptions): Promise<void>;
-export declare function dockerDown(options?: DockerOptions): Promise<void>;
-export declare function dockerStatus(options?: DockerOptions): Promise<void>;
-export declare function dockerLogs(options?: DockerOptions & {
-    follow?: boolean;
-    service?: string;
-}): Promise<void>;
-export declare function dockerRestart(options?: DockerOptions): Promise<void>;
-export declare function dockerExec(service: string, command: string[], options?: DockerOptions): Promise<number>;
-//# sourceMappingURL=docker.d.ts.map

package/libs/cli/dist/commands/docker.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"docker.d.ts","sourceRoot":"","sources":["../../lib/commands/docker.ts"],"names":[],"mappings":"AAAA;;GAEG;AAiEH,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAeD,wBAAsB,QAAQ,CAAC,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoBzE;AAED,wBAAsB,UAAU,CAAC,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAW3E;AAED,wBAAsB,YAAY,CAAC,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAK7E;AAED,wBAAsB,UAAU,CAC9B,OAAO,GAAE,aAAa,GAAG;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GACnE,OAAO,CAAC,IAAI,CAAC,CAiBf;AAED,wBAAsB,aAAa,CAAC,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAW9E;AAED,wBAAsB,UAAU,CAC9B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EAAE,EACjB,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,MAAM,CAAC,CAWjB"}

package/libs/cli/dist/commands/doctor.d.ts

@@ -1,9 +0,0 @@
-/**
- * doctor command - Check prerequisites and system health
- */
-export declare function doctor(): Promise<void>;
-/**
- * Check if NVIDIA GPU is available (exported for use by init command)
- */
-export declare function hasNvidiaGpu(): Promise<boolean>;
-//# sourceMappingURL=doctor.d.ts.map

package/libs/cli/dist/commands/doctor.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../lib/commands/doctor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAmRH,wBAAsB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CA+B5C;AAED;;GAEG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,OAAO,CAAC,CAMrD"}

package/libs/cli/dist/commands/index.d.ts

@@ -1,6 +0,0 @@
-export { init } from './init';
-export { doctor } from './doctor';
-export { configShow, configPaths } from './config';
-export { dockerUp, dockerDown, dockerStatus, dockerLogs, dockerRestart, dockerExec } from './docker';
-export { modelsList, modelsPull, modelsRm, modelsShow, modelsRun } from './models';
-//# sourceMappingURL=index.d.ts.map

package/libs/cli/dist/commands/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../lib/commands/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACrG,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC"}

package/libs/cli/dist/commands/init.d.ts

@@ -1,11 +0,0 @@
-/**
- * init command - Scaffold docker-compose.yml and config
- */
-export interface InitOptions {
-    force?: boolean;
-    noWebui?: boolean;
-    gpu?: boolean;
-    noGpu?: boolean;
-}
-export declare function init(options?: InitOptions): Promise<void>;
-//# sourceMappingURL=init.d.ts.map

package/libs/cli/dist/commands/init.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../lib/commands/init.ts"],"names":[],"mappings":"AAAA;;GAEG;AA4nBH,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,wBAAsB,IAAI,CAAC,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAsInE"}

package/libs/cli/dist/commands/models.d.ts

@@ -1,9 +0,0 @@
-/**
- * models command - Manage Ollama models
- */
-export declare function modelsList(): Promise<void>;
-export declare function modelsPull(modelName: string): Promise<void>;
-export declare function modelsRm(modelName: string): Promise<void>;
-export declare function modelsShow(modelName: string): Promise<void>;
-export declare function modelsRun(modelName: string): Promise<void>;
-//# sourceMappingURL=models.d.ts.map

package/libs/cli/dist/commands/models.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../../lib/commands/models.ts"],"names":[],"mappings":"AAAA;;GAEG;AAiFH,wBAAsB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAyChD;AAED,wBAAsB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBjE;AAED,wBAAsB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAiB/D;AAED,wBAAsB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAWjE;AAED,wBAAsB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAWhE"}

package/libs/cli/dist/config.d.ts

@@ -1,74 +0,0 @@
-/**
- * Configuration system for loclaude
- *
- * Priority (highest to lowest):
- * 1. CLI arguments
- * 2. Environment variables
- * 3. Project config (./.loclaude/config.json)
- * 4. User config (~/.config/loclaude/config.json)
- * 5. Default values
- */
-export interface OllamaConfig {
-    url: string;
-    defaultModel: string;
-}
-export interface DockerConfig {
-    composeFile: string;
-    gpu: boolean;
-}
-export interface ClaudeConfig {
-    extraArgs: string[];
-}
-export interface LoclaudeConfig {
-    ollama: OllamaConfig;
-    docker: DockerConfig;
-    claude: ClaudeConfig;
-}
-export interface LoclaudeConfigPartial {
-    ollama?: Partial<OllamaConfig>;
-    docker?: Partial<DockerConfig>;
-    claude?: Partial<ClaudeConfig>;
-}
-/**
- * Load the full configuration
- *
- * Merges (in order of priority):
- * 1. Environment variables
- * 2. Project config file
- * 3. User config file
- * 4. Defaults
- */
-export declare function loadConfig(): LoclaudeConfig;
-/**
- * Clear the config cache (useful for testing)
- */
-export declare function clearConfigCache(): void;
-/**
- * Get the path to the active config file (if any)
- */
-export declare function getActiveConfigPath(): string | null;
-/**
- * Get all config paths that are checked
- */
-export declare function getConfigSearchPaths(): string[];
-/**
- * Get Ollama URL from config
- */
-export declare function getOllamaUrl(): string;
-/**
- * Get default model from config
- */
-export declare function getDefaultModel(): string;
-/**
- * Get docker compose file path from config
- */
-export declare function getComposeFile(): string;
-/**
- * Check if GPU is enabled in config
- */
-export declare function isGpuEnabled(): boolean;
-/**
- * Get extra Claude args from config
- */
-export declare function getClaudeExtraArgs(): string[];
-//# sourceMappingURL=config.d.ts.map

package/libs/cli/dist/config.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../lib/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAUH,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,OAAO,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,YAAY,CAAC;CACtB;AAGD,MAAM,WAAW,qBAAqB;IACpC,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IAC/B,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IAC/B,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;CAChC;AAkLD;;;;;;;;GAQG;AACH,wBAAgB,UAAU,IAAI,cAAc,CAgB3C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,GAAG,IAAI,CAEnD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,EAAE,CAE/C;AAMD;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,OAAO,CAEtC;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,EAAE,CAE7C"}

package/libs/cli/dist/constants.d.ts

@@ -1,12 +0,0 @@
-/**
- * Constants - Loaded from configuration system
- *
- * Values come from (in priority order):
- * 1. Environment variables (OLLAMA_URL, OLLAMA_MODEL)
- * 2. Project config (.loclaude/config.json)
- * 3. User config (~/.config/loclaude/config.json)
- * 4. Default values
- */
-export declare const OLLAMA_URL: string;
-export declare const DEFAULT_MODEL: string;
-//# sourceMappingURL=constants.d.ts.map

package/libs/cli/dist/constants.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../lib/constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,eAAO,MAAM,UAAU,QAAiB,CAAC;AACzC,eAAO,MAAM,aAAa,QAAoB,CAAC"}