@codeshareme/codeshare-cli 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026
+
+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,351 @@
+# codeshare-cli
+
+> Official CLI for [codeshare.me](https://codeshare.me) — version-control your code snippets directly from the terminal.
+
+Push, pull, diff and track the history of your CodeShare snippets just like you would with Git — without needing Git.
+
+📖 **Full documentation:** [codeshare.me/docs/cli](https://codeshare.me/docs/cli)
+
+---
+
+## Table of Contents
+
+- [Installation](#installation)
+- [Authentication](#authentication)
+- [Quick Start](#quick-start)
+- [Commands](#commands)
+  - [login](#login)
+  - [logout](#logout)
+  - [whoami](#whoami)
+  - [init](#init)
+  - [push](#push)
+  - [pull](#pull)
+  - [clone](#clone)
+  - [log](#log)
+  - [diff](#diff)
+  - [status](#status)
+- [File Filtering](#file-filtering)
+- [.csproject File](#csproject-file)
+- [Limits](#limits)
+- [Supported Languages](#supported-languages)
+- [Requirements](#requirements)
+
+---
+
+## Installation
+
+```bash
+npm install -g codeshare-cli
+```
+
+Verify the installation:
+
+```bash
+cs --version
+cs --help
+```
+
+---
+
+## Authentication
+
+1. Log in to [codeshare.me](https://codeshare.me) and go to **Settings → Personal Access Tokens**
+2. Enter a name (e.g. `my-laptop`) and click **Generate Token**
+3. **Copy the token immediately** — it is shown only once
+4. Run:
+
+```bash
+cs login --token <your-token>
+```
+
+Your token is stored in `~/.codeshare/config.json` with `600` file permissions (readable only by you).
+
+---
+
+## Quick Start
+
+```bash
+# Authenticate
+cs login --token cs_xxxxxxxxxxxxxxxxxxxxxx
+
+# Go to your project folder
+cd my-project
+
+# Create a new snippet linked to this folder
+cs init --title "My Awesome Project"
+
+# Upload your files as version 1
+cs push -m "initial commit"
+
+# Make some changes, then push again
+cs push -m "fix: handle edge case"
+
+# See the version history
+cs log
+
+# See what changed between version 1 and 2
+cs diff 1 2
+
+# Check if local files are in sync with the latest version
+cs status
+```
+
+---
+
+## Commands
+
+### `login`
+
+Save your personal access token locally.
+
+```bash
+cs login --token <token>
+cs login --token <token> --host https://codeshare.me
+```
+
+| Option | Description |
+|---|---|
+| `--token <token>` | Your personal access token (prompted interactively if omitted) |
+| `--host <url>` | Override the API host (default: `https://codeshare.me`) |
+
+---
+
+### `logout`
+
+Remove the saved token from your machine.
+
+```bash
+cs logout
+```
+
+---
+
+### `whoami`
+
+Show who you are currently logged in as.
+
+```bash
+cs whoami
+```
+
+```
+Logged in as johndoe
+  Host:  https://codeshare.me
+  Token: cs_abc123…
+```
+
+---
+
+### `init`
+
+Create a new snippet on CodeShare and link the current directory to it. Writes a `.csproject` file in the current folder.
+
+```bash
+cs init
+cs init --title "React Authentication Flow"
+cs init --title "My API" --private
+```
+
+| Option | Description |
+|---|---|
+| `--title <title>` | Snippet title (prompted if omitted) |
+| `--private` | Create as a private snippet (default: public) |
+
+After running `init`, use `cs push` to upload your files.
+
+---
+
+### `push`
+
+Scan the current directory, upload all files and create a new version snapshot.
+
+```bash
+cs push
+cs push -m "add error handling"
+cs push --message "refactor: split into modules"
+```
+
+| Option | Description |
+|---|---|
+| `-m, --message <msg>` | Commit message (default: `"Update"`) |
+
+**What gets uploaded:**
+
+- All files in the current directory (recursively)
+- Respects `.gitignore` and `.csignore`
+- Skips: `node_modules`, `dist`, `build`, `.git`, `.env`, lock files, binary files
+
+**Limits:** max 500 files, 512 KB per file, 50 MB total per push.
+
+Each `push` creates a new immutable version. You can always go back.
+
+---
+
+### `pull`
+
+Download the latest files from your snippet into the current directory.
+
+```bash
+cs pull
+cs pull <snippetId>
+```
+
+Existing files will be **overwritten**. New files from the snippet will be created. Files not present in the snippet are left untouched.
+
+---
+
+### `clone`
+
+Clone any **public** snippet into the current directory.
+
+```bash
+cs clone <snippetId>
+```
+
+A `.csproject` file is written so you can `cs push` changes back (requires ownership).
+
+---
+
+### `log`
+
+Show the version history of the current snippet.
+
+```bash
+cs log
+cs log <snippetId>
+```
+
+```
+v3 — Jan 15, 2026, 3:42 PM
+  refactor: split into modules
+
+v2 — Jan 14, 2026, 11:20 AM
+  add error handling
+
+v1 — Jan 13, 2026, 9:05 AM
+  initial commit
+```
+
+---
+
+### `diff`
+
+Show line-level changes between two versions.
+
+```bash
+cs diff <v1> <v2>
+cs diff 1 3
+cs diff 2 3 <snippetId>
+```
+
+```
+MODIFIED  src/index.ts
++  export function handleError(e: Error) {
++    console.error(e.message);
++  }
+-  // TODO: add error handler
+```
+
+---
+
+### `status`
+
+Compare your current working files against the latest pushed version.
+
+```bash
+cs status
+cs status <snippetId>
+```
+
+```
+✓ Clean — up to date with version 3
+```
+
+or if there are local changes:
+
+```
+Changes since version 3:
+  M  src/index.ts
+  A  src/utils.ts
+  D  src/old.ts
+```
+
+---
+
+## File Filtering
+
+The CLI automatically ignores certain files and directories. You can add your own exclusions using a `.csignore` file (same syntax as `.gitignore`):
+
+```gitignore
+# .csignore
+secrets/
+coverage/
+*.key
+*.pem
+data/*.csv
+```
+
+**Always ignored by default:**
+
+```
+.git  .svn  .hg
+node_modules
+dist  build  .next  out  .nuxt
+.cache  .parcel-cache  .turbo
+*.log
+.DS_Store  Thumbs.db
+.env  .env.*  (exceptions: .env.example)
+*.lock  yarn.lock  package-lock.json  pnpm-lock.yaml
+.csproject
+```
+
+Your `.gitignore` is also respected automatically.
+
+---
+
+## .csproject File
+
+When you run `cs init` or `cs clone`, a `.csproject` file is created in your directory:
+
+```json
+{
+  "id": "a1b2c3d4-...",
+  "title": "My Project"
+}
+```
+
+This file links your local directory to a CodeShare snippet. It can safely be committed to Git.
+
+---
+
+## Limits
+
+| Limit | Value |
+|---|---|
+| Max files per push | 500 |
+| Max file size | 512 KB |
+| Max total push size | 50 MB |
+| Max active tokens | 10 per account |
+| Token max length | 200 characters |
+
+---
+
+## Supported Languages
+
+Auto-detected from file extension:
+
+`TypeScript` · `JavaScript` · `Python` · `Ruby` · `Go` · `Rust` · `Java` · `C#` · `C/C++` · `HTML` · `CSS` · `SCSS` · `JSON` · `YAML` · `TOML` · `XML` · `Markdown` · `Bash` · `SQL` · `PHP` · `Swift` · `Kotlin` · `R` · `Lua` · `Dart` · `Elixir`
+
+---
+
+## Requirements
+
+- **Node.js** 18 or later
+- A [codeshare.me](https://codeshare.me) account
+- A Personal Access Token (from Settings → Personal Access Tokens)
+
+---
+
+## License
+
+MIT © [codeshare.me](https://codeshare.me)

package/dist/api.d.ts

@@ -0,0 +1,8 @@
+export declare class APIError extends Error {
+    status: number;
+    constructor(status: number, message: string);
+}
+export declare const api: {
+    post: <T = any>(path: string, body: any, token?: string) => Promise<T>;
+    get: <T = any>(path: string, token?: string) => Promise<T>;
+};

package/dist/api.js

@@ -0,0 +1,30 @@
+import { readConfig } from './config.js';
+export class APIError extends Error {
+    status;
+    constructor(status, message) {
+        super(message);
+        this.status = status;
+    }
+}
+async function request(method, path, body, token) {
+    const cfg = readConfig();
+    const host = cfg.host.replace(/\/$/, '');
+    const tok = token ?? cfg.token;
+    const res = await fetch(`${host}/api${path}`, {
+        method,
+        headers: {
+            'Content-Type': 'application/json',
+            ...(tok ? { Authorization: `Bearer ${tok}` } : {}),
+        },
+        body: body !== undefined ? JSON.stringify(body) : undefined,
+    });
+    const json = await res.json().catch(() => ({ error: res.statusText }));
+    if (!res.ok) {
+        throw new APIError(res.status, json?.error ?? json?.message ?? res.statusText);
+    }
+    return json;
+}
+export const api = {
+    post: (path, body, token) => request('POST', path, body, token),
+    get: (path, token) => request('GET', path, undefined, token),
+};

package/dist/config.d.ts

@@ -0,0 +1,7 @@
+export interface Config {
+    token?: string;
+    host: string;
+}
+export declare function readConfig(): Config;
+export declare function writeConfig(config: Partial<Config>): void;
+export declare function requireToken(): string;

package/dist/config.js

@@ -0,0 +1,42 @@
+import { homedir } from 'os';
+import { join } from 'path';
+import { existsSync, mkdirSync, readFileSync, writeFileSync, chmodSync } from 'fs';
+const CONFIG_DIR = join(homedir(), '.codeshare');
+const CONFIG_FILE = join(CONFIG_DIR, 'config.json');
+const defaults = {
+    host: 'https://codeshare.me',
+};
+export function readConfig() {
+    if (!existsSync(CONFIG_FILE))
+        return { ...defaults };
+    try {
+        return { ...defaults, ...JSON.parse(readFileSync(CONFIG_FILE, 'utf8')) };
+    }
+    catch {
+        return { ...defaults };
+    }
+}
+export function writeConfig(config) {
+    if (!existsSync(CONFIG_DIR))
+        mkdirSync(CONFIG_DIR, { recursive: true, mode: 0o700 });
+    const existing = readConfig();
+    writeFileSync(CONFIG_FILE, JSON.stringify({ ...existing, ...config }, null, 2), { mode: 0o600 });
+    // Ensure permissions are tight even if files/dirs already existed
+    try {
+        chmodSync(CONFIG_DIR, 0o700);
+    }
+    catch { /* non-fatal */ }
+    try {
+        chmodSync(CONFIG_FILE, 0o600);
+    }
+    catch { /* non-fatal */ }
+}
+export function requireToken() {
+    const { token } = readConfig();
+    if (!token) {
+        console.error('Not logged in. Run: cs login --token <your-token>');
+        console.error('Get a token at: https://codeshare.me/settings (Personal Access Tokens section)');
+        process.exit(1);
+    }
+    return token;
+}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,277 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { readConfig, writeConfig } from './config.js';
+import { writeProject, requireProject } from './project.js';
+import { scanFiles } from './scanner.js';
+import { api } from './api.js';
+import { requireToken } from './config.js';
+import { writeFileSync, mkdirSync } from 'fs';
+import { join, dirname } from 'path';
+import ora from 'ora';
+import prompts from 'prompts';
+const program = new Command();
+program
+    .name('cs')
+    .description('CodeShare CLI — version-control your code snippets')
+    .version('1.0.0');
+// ─── LOGIN ────────────────────────────────────────────────────────────────────
+program
+    .command('login')
+    .description('Save your personal access token')
+    .option('--token <token>', 'Personal access token from codeshare.me/settings')
+    .option('--host <host>', 'Custom host (default: https://codeshare.me)')
+    .action(async (opts) => {
+    let token = opts.token;
+    let host = opts.host;
+    if (!token) {
+        const res = await prompts({ type: 'password', name: 'token', message: 'Token (from codeshare.me/settings):' });
+        token = res.token;
+    }
+    if (!token) {
+        console.error(chalk.red('No token provided'));
+        process.exit(1);
+    }
+    if (host)
+        writeConfig({ host });
+    // Verify token by hitting a simple endpoint
+    const spinner = ora('Verifying token…').start();
+    try {
+        const data = await api.get('/cli/me', token);
+        spinner.succeed(chalk.green(`Logged in as ${data.user?.username ?? 'user'}!`));
+        writeConfig({ token });
+    }
+    catch (e) {
+        spinner.fail(chalk.red(`Token verification failed: ${e.message}`));
+        process.exit(1);
+    }
+});
+// ─── LOGOUT ───────────────────────────────────────────────────────────────────
+program
+    .command('logout')
+    .description('Remove saved token')
+    .action(() => {
+    writeConfig({ token: undefined });
+    console.log(chalk.green('Logged out.'));
+});
+// ─── INIT ─────────────────────────────────────────────────────────────────────
+program
+    .command('init')
+    .description('Create a new snippet and link this directory to it')
+    .option('--title <title>', 'Snippet title')
+    .option('--id <id>', 'Link to an existing snippet ID instead of creating a new one')
+    .option('--private', 'Make the snippet private')
+    .action(async (opts) => {
+    const token = requireToken();
+    if (opts.id) {
+        writeProject({ id: opts.id });
+        console.log(chalk.green(`✓ Linked to snippet ${opts.id}`));
+        console.log('Run ' + chalk.cyan('cs push') + ' to upload your files.');
+        return;
+    }
+    let title = opts.title;
+    if (!title) {
+        const res = await prompts({ type: 'text', name: 'title', message: 'Snippet title:', initial: dirname(process.cwd()).split('/').pop() ?? 'My Project' });
+        title = res.title;
+    }
+    if (!title) {
+        console.error(chalk.red('Title is required'));
+        process.exit(1);
+    }
+    const spinner = ora('Creating snippet…').start();
+    try {
+        const data = await api.post('/cli/init', { title, isPublic: !opts.private, language: 'text' }, token);
+        spinner.succeed(chalk.green(`Snippet created: ${data.snippet.url}`));
+        writeProject({ id: data.snippet.id, title });
+        console.log(chalk.gray('.csproject written — run ') + chalk.cyan('cs push') + chalk.gray(' to upload your files.'));
+    }
+    catch (e) {
+        spinner.fail(chalk.red(e.message));
+        process.exit(1);
+    }
+});
+// ─── PUSH ─────────────────────────────────────────────────────────────────────
+program
+    .command('push [snippetId]')
+    .description('Push local files to CodeShare (creates a new version)')
+    .option('-m, --message <message>', 'Commit message', 'Update')
+    .option('--dir <dir>', 'Directory to push (default: current directory)', process.cwd())
+    .action(async (snippetId, opts) => {
+    const token = requireToken();
+    const project = snippetId ? { id: snippetId } : requireProject();
+    const spinner = ora('Scanning files…').start();
+    const files = scanFiles(opts.dir);
+    if (files.length === 0) {
+        spinner.fail(chalk.red('No files found to push.'));
+        process.exit(1);
+    }
+    spinner.text = `Pushing ${files.length} files…`;
+    try {
+        const data = await api.post(`/cli/push/${project.id}`, { message: opts.message, files }, token);
+        if (!snippetId)
+            writeProject({ ...project }); // ensure .csproject stays
+        const host = readConfig().host;
+        spinner.succeed(chalk.green(`✓ Pushed ${data.filesUploaded} files → version ${data.version}`));
+        console.log(chalk.gray('  URL: ') + chalk.cyan(`${host}/c/${project.id}`));
+    }
+    catch (e) {
+        spinner.fail(chalk.red(e.message));
+        process.exit(1);
+    }
+});
+// ─── PULL ─────────────────────────────────────────────────────────────────────
+program
+    .command('pull [snippetId]')
+    .description('Pull latest files from CodeShare into current directory')
+    .option('--dir <dir>', 'Target directory (default: current directory)', process.cwd())
+    .action(async (snippetId, opts) => {
+    const token = requireToken();
+    const project = snippetId ? { id: snippetId } : requireProject();
+    const spinner = ora('Fetching files…').start();
+    try {
+        const data = await api.get(`/cli/pull/${project.id}`, token);
+        spinner.text = `Writing ${data.files.length} files…`;
+        for (const f of data.files) {
+            if (f.type !== 'file')
+                continue;
+            const dest = join(opts.dir, f.path);
+            mkdirSync(dirname(dest), { recursive: true });
+            writeFileSync(dest, f.content ?? '', 'utf8');
+        }
+        writeProject({ id: project.id, title: data.snippet?.title });
+        spinner.succeed(chalk.green(`✓ Pulled ${data.files.filter((f) => f.type === 'file').length} files (version ${data.latestVersion})`));
+    }
+    catch (e) {
+        spinner.fail(chalk.red(e.message));
+        process.exit(1);
+    }
+});
+// ─── CLONE ────────────────────────────────────────────────────────────────────
+program
+    .command('clone <snippetId> [dir]')
+    .description('Clone a public snippet into a new directory')
+    .action(async (snippetId, dir) => {
+    const token = requireToken();
+    const targetDir = dir ?? snippetId;
+    const spinner = ora(`Cloning ${snippetId}…`).start();
+    try {
+        const data = await api.get(`/cli/clone/${snippetId}`, token);
+        mkdirSync(targetDir, { recursive: true });
+        for (const f of data.files) {
+            if (f.type !== 'file')
+                continue;
+            const dest = join(targetDir, f.path);
+            mkdirSync(dirname(dest), { recursive: true });
+            writeFileSync(dest, f.content ?? '', 'utf8');
+        }
+        writeProject({ id: snippetId, title: data.snippet?.title }, targetDir);
+        spinner.succeed(chalk.green(`✓ Cloned '${data.snippet.title}' into ./${targetDir}/ (${data.files.length} files)`));
+    }
+    catch (e) {
+        spinner.fail(chalk.red(e.message));
+        process.exit(1);
+    }
+});
+// ─── LOG ──────────────────────────────────────────────────────────────────────
+program
+    .command('log [snippetId]')
+    .description('Show version history')
+    .action(async (snippetId) => {
+    const token = requireToken();
+    const project = snippetId ? { id: snippetId } : requireProject();
+    try {
+        const data = await api.get(`/cli/log/${project.id}`, token);
+        if (data.versions.length === 0) {
+            console.log(chalk.gray('No versions yet.'));
+            return;
+        }
+        for (const v of data.versions) {
+            const date = new Date(v.createdAt).toLocaleString('en-US', { month: 'short', day: 'numeric', year: 'numeric', hour: '2-digit', minute: '2-digit' });
+            console.log(chalk.yellow(`v${v.versionNumber}`) + chalk.gray(` — ${date}`));
+            console.log(`  ${v.changeLog ?? '(no message)'}`);
+        }
+    }
+    catch (e) {
+        console.error(chalk.red(e.message));
+        process.exit(1);
+    }
+});
+// ─── STATUS ───────────────────────────────────────────────────────────────────
+program
+    .command('status [snippetId]')
+    .description('Show what has changed vs the latest version')
+    .action(async (snippetId) => {
+    const token = requireToken();
+    const project = snippetId ? { id: snippetId } : requireProject();
+    try {
+        const data = await api.get(`/cli/status/${project.id}`, token);
+        if (data.status === 'unversioned') {
+            console.log(chalk.gray('No versions yet — push to create the first one.'));
+            return;
+        }
+        if (data.clean) {
+            console.log(chalk.green(`✓ Clean — up to date with version ${data.latestVersion}`));
+            return;
+        }
+        console.log(chalk.yellow(`Changes since version ${data.latestVersion}:`));
+        for (const c of data.changes) {
+            const symbol = c.status === 'added' ? chalk.green('+') : c.status === 'removed' ? chalk.red('-') : chalk.yellow('M');
+            console.log(`  ${symbol} ${c.path}`);
+        }
+    }
+    catch (e) {
+        console.error(chalk.red(e.message));
+        process.exit(1);
+    }
+});
+// ─── DIFF ─────────────────────────────────────────────────────────────────────
+program
+    .command('diff <v1> <v2> [snippetId]')
+    .description('Show diff between two versions')
+    .action(async (v1, v2, snippetId) => {
+    const token = requireToken();
+    const project = snippetId ? { id: snippetId } : requireProject();
+    try {
+        const data = await api.get(`/cli/diff/${project.id}/${v1}/${v2}`, token);
+        for (const file of data.diff) {
+            if (file.status === 'unchanged')
+                continue;
+            const color = file.status === 'added' ? chalk.greenBright : file.status === 'removed' ? chalk.redBright : chalk.blueBright;
+            console.log(color(`\n${file.status.toUpperCase()}  ${file.path}`));
+            if (file.lines) {
+                for (const line of file.lines) {
+                    if (line.type === '+')
+                        console.log(chalk.green(`+  ${line.text}`));
+                    else if (line.type === '-')
+                        console.log(chalk.red(`-  ${line.text}`));
+                }
+            }
+        }
+    }
+    catch (e) {
+        console.error(chalk.red(e.message));
+        process.exit(1);
+    }
+});
+// ─── WHOAMI ───────────────────────────────────────────────────────────────────
+program
+    .command('whoami')
+    .description('Show current login info')
+    .action(async () => {
+    const cfg = readConfig();
+    if (!cfg.token) {
+        console.log(chalk.gray('Not logged in. Run: cs login --token <token>'));
+    }
+    else {
+        try {
+            const data = await api.get('/cli/me', cfg.token);
+            console.log(chalk.green(`Logged in as ${data.user?.username ?? 'unknown'}`));
+        }
+        catch {
+            console.log(chalk.green('Logged in'));
+        }
+        console.log(chalk.gray(`  Host:  ${cfg.host}`));
+        console.log(chalk.gray(`  Token: ${cfg.token.slice(0, 10)}…`));
+    }
+});
+program.parse();

package/dist/project.d.ts

@@ -0,0 +1,8 @@
+export interface ProjectConfig {
+    id: string;
+    title?: string;
+    host?: string;
+}
+export declare function readProject(cwd?: string): ProjectConfig | null;
+export declare function writeProject(config: ProjectConfig, cwd?: string): void;
+export declare function requireProject(cwd?: string): ProjectConfig;

package/dist/project.js

@@ -0,0 +1,29 @@
+/**
+ * .csproject — local per-repo config file (committed to snippet)
+ * Stores snippetId so cs push/pull/etc know which snippet this maps to
+ */
+import { existsSync, readFileSync, writeFileSync } from 'fs';
+import { join } from 'path';
+const PROJECT_FILE = '.csproject';
+export function readProject(cwd = process.cwd()) {
+    const file = join(cwd, PROJECT_FILE);
+    if (!existsSync(file))
+        return null;
+    try {
+        return JSON.parse(readFileSync(file, 'utf8'));
+    }
+    catch {
+        return null;
+    }
+}
+export function writeProject(config, cwd = process.cwd()) {
+    writeFileSync(join(cwd, PROJECT_FILE), JSON.stringify(config, null, 2));
+}
+export function requireProject(cwd = process.cwd()) {
+    const p = readProject(cwd);
+    if (!p) {
+        console.error('No .csproject file found. Run "cs init" or "cs clone <id>" first.');
+        process.exit(1);
+    }
+    return p;
+}

package/dist/scanner.d.ts

@@ -0,0 +1,9 @@
+export interface LocalFile {
+    name: string;
+    path: string;
+    content: string;
+    language: string;
+    type: 'file';
+    isMain: boolean;
+}
+export declare function scanFiles(cwd: string): LocalFile[];

package/dist/scanner.js

@@ -0,0 +1,82 @@
+import { readdirSync, readFileSync, statSync, existsSync } from 'fs';
+import { join, relative } from 'path';
+import ignore from 'ignore';
+const DEFAULT_IGNORE = [
+    '.git', '.svn', '.hg',
+    'node_modules', '.pnp', '.pnp.js',
+    'dist', 'build', '.next', 'out', '.nuxt',
+    '.cache', '.parcel-cache', '.turbo',
+    '*.log', 'npm-debug.log*', 'yarn-debug.log*',
+    '.DS_Store', 'Thumbs.db', 'desktop.ini',
+    '.env', '.env.*', '!.env.example',
+    '.csproject',
+    '*.lock', 'yarn.lock', 'package-lock.json', 'pnpm-lock.yaml',
+];
+const MAX_FILE_SIZE = 512 * 1024; // 512 KB per file
+const MAX_TOTAL_FILES = 500;
+function guessLanguage(filename) {
+    const ext = filename.split('.').pop()?.toLowerCase() ?? '';
+    const map = {
+        ts: 'typescript', tsx: 'typescript', js: 'javascript', jsx: 'javascript',
+        py: 'python', rb: 'ruby', go: 'go', rs: 'rust', java: 'java',
+        cs: 'csharp', cpp: 'cpp', c: 'c', h: 'c', hpp: 'cpp',
+        html: 'html', css: 'css', scss: 'scss', sass: 'sass',
+        json: 'json', yaml: 'yaml', yml: 'yaml', toml: 'toml', xml: 'xml',
+        md: 'markdown', mdx: 'markdown', sh: 'bash', bash: 'bash',
+        sql: 'sql', php: 'php', swift: 'swift', kt: 'kotlin',
+        r: 'r', lua: 'lua', dart: 'dart', ex: 'elixir', exs: 'elixir',
+    };
+    return map[ext] ?? 'text';
+}
+export function scanFiles(cwd) {
+    const ig = ignore().add(DEFAULT_IGNORE);
+    const csignorePath = join(cwd, '.csignore');
+    if (existsSync(csignorePath)) {
+        ig.add(readFileSync(csignorePath, 'utf8'));
+    }
+    const gitignorePath = join(cwd, '.gitignore');
+    if (existsSync(gitignorePath)) {
+        ig.add(readFileSync(gitignorePath, 'utf8'));
+    }
+    const files = [];
+    let mainFile = null;
+    function walk(dir) {
+        if (files.length >= MAX_TOTAL_FILES)
+            return;
+        const entries = readdirSync(dir, { withFileTypes: true });
+        for (const e of entries) {
+            const fullPath = join(dir, e.name);
+            const relPath = relative(cwd, fullPath).replace(/\\/g, '/');
+            if (ig.ignores(relPath))
+                continue;
+            if (e.isDirectory()) {
+                walk(fullPath);
+            }
+            else if (e.isFile()) {
+                const stat = statSync(fullPath);
+                if (stat.size > MAX_FILE_SIZE)
+                    continue;
+                try {
+                    const content = readFileSync(fullPath, 'utf8');
+                    const lang = guessLanguage(e.name);
+                    // Detect main file: index.*, main.*, App.*
+                    const isMain = /^(index|main|app)\.(ts|tsx|js|jsx|py|go|rs|java|rb)$/i.test(e.name);
+                    if (isMain && !mainFile)
+                        mainFile = relPath;
+                    files.push({ name: e.name, path: relPath, content, language: lang, type: 'file', isMain: false });
+                }
+                catch {
+                    // Skip binary files or unreadable files
+                }
+            }
+        }
+    }
+    walk(cwd);
+    // Mark the main file
+    if (mainFile) {
+        const mf = files.find(f => f.path === mainFile);
+        if (mf)
+            mf.isMain = true;
+    }
+    return files;
+}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@codeshareme/codeshare-cli",
+  "version": "1.0.0",
+  "description": "Official CLI for codeshare.me — push, pull and version-control your code snippets",
+  "homepage": "https://codeshare.me",
+  "license": "MIT",
+  "keywords": [
+    "codeshare",
+    "cli",
+    "code",
+    "snippets",
+    "version-control"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "dist"
+  ],
+  "bin": {
+    "cs": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "commander": "^12.0.0",
+    "chalk": "^5.3.0",
+    "ora": "^8.0.1",
+    "glob": "^10.4.1",
+    "ignore": "^5.3.1",
+    "diff": "^5.2.0",
+    "prompts": "^2.4.2",
+    "fs-extra": "^11.2.0",
+    "node-fetch": "^3.3.2"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@types/diff": "^5.2.1",
+    "@types/fs-extra": "^11.0.4",
+    "@types/prompts": "^2.4.9",
+    "typescript": "^5.4.0",
+    "tsx": "^4.7.0"
+  },
+  "type": "module"
+}