reposizer 0.1.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,116 @@
+# reposizer
+
+> Fast CLI to inspect GitHub repository sizes.
+
+Check repo size before you clone. Analyze large codebases instantly.
+
+## Demo
+
+```bash
+npx reposizer torvalds/linux
+```
+
+```text
+Repository: torvalds/linux
+Size: 4.82 GB
+Stars: 190k
+Language: C
+```
+
+## Features
+
+- ⚡ Instant repository size lookup
+- 🔐 Supports private repositories via `GITHUB_TOKEN`
+- 📦 Works with `npx` (no global install required)
+- 🧩 JSON output for scripts and CI tooling
+- 🏢 Organization repository scanning
+- 🔎 Current repository auto-detection (via git remote)
+- 📚 Multi-repository lookup in one command
+- 📊 Directory analysis (planned)
+
+## Installation
+
+### Option 1: no install (recommended)
+
+```bash
+npx reposizer owner/repo
+```
+
+### Option 2: global install
+
+```bash
+npm install -g reposizer
+```
+
+## Usage
+
+### Check repository size
+
+```bash
+reposizer openai/gym
+```
+
+### Check multiple repositories
+
+```bash
+reposizer openai/gym vercel/next.js torvalds/linux
+```
+
+### Detect current repository automatically
+
+```bash
+reposizer
+```
+
+### Scan an organization
+
+```bash
+reposizer org openai
+reposizer org openai --limit 50 --json
+```
+
+### JSON output
+
+```bash
+reposizer openai/gym --json
+```
+
+### Private repository access
+
+```bash
+export GITHUB_TOKEN=your_token
+reposizer your-org/private-repo
+```
+
+## Example JSON Output
+
+```json
+{
+  "repository": "openai/gym",
+  "size_mb": 92.15,
+  "stars": 31000,
+  "language": "Python"
+}
+```
+
+## Roadmap
+
+- [x] Organization scanning
+- [x] Current repository auto-detection
+- [x] Multi-repository support
+- [ ] Directory size analysis
+- [ ] CI/CD threshold mode
+- [ ] Repository growth tracking
+
+## Why
+
+Cloning a massive repository blindly is painful. Reposizer helps you inspect before you pull.
+
+## Security Notes
+
+- `GITHUB_TOKEN` is optional and used only for request authorization.
+- Tokens are never printed to output or written to disk.
+
+## License
+
+MIT - see [`LICENSE`](LICENSE).

package/dist/bin/reposizer.js

@@ -0,0 +1,44 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const repo_1 = require("../src/commands/repo");
+const program = new commander_1.Command();
+program
+    .name("reposizer")
+    .description("Fast CLI to inspect GitHub repository sizes");
+program
+    .argument("[repositories...]", "One or more repositories in owner/repo format")
+    .option("--json", "Return machine-readable JSON output")
+    .action(async (repositories = [], options) => {
+    try {
+        await (0, repo_1.runRepositoriesCommand)(repositories, Boolean(options.json));
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : "Unexpected error occurred";
+        console.error(`Error: ${message}`);
+        process.exitCode = 1;
+    }
+})
+    .addHelpText("after", "\nExamples:\n  reposizer openai/gym\n  reposizer openai/gym vercel/next.js\n  reposizer --json");
+program
+    .command("org")
+    .description("Scan repositories in a GitHub organization")
+    .argument("<organization>", "GitHub organization name")
+    .option("--limit <number>", "Maximum repositories to scan (1-100)", "30")
+    .option("--json", "Return machine-readable JSON output")
+    .action(async (organization, options) => {
+    try {
+        const limit = Number.parseInt(options.limit, 10);
+        if (!Number.isFinite(limit) || limit < 1 || limit > 100) {
+            throw new Error("Invalid --limit value. Use a number between 1 and 100.");
+        }
+        await (0, repo_1.runOrganizationCommand)(organization, Boolean(options.json), limit);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : "Unexpected error occurred";
+        console.error(`Error: ${message}`);
+        process.exitCode = 1;
+    }
+});
+program.parseAsync(process.argv);

package/dist/src/commands/repo.js

@@ -0,0 +1,108 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runRepoCommand = runRepoCommand;
+exports.runRepositoriesCommand = runRepositoriesCommand;
+exports.runOrganizationCommand = runOrganizationCommand;
+const github_1 = require("../services/github");
+const git_1 = require("../utils/git");
+const size_1 = require("../utils/size");
+function parseRepository(input) {
+    const trimmed = input.trim();
+    const match = /^([^/\s]+)\/([^/\s]+)$/.exec(trimmed);
+    if (!match) {
+        throw new Error("Invalid repository format. Use owner/repo.");
+    }
+    return { owner: match[1], repo: match[2] };
+}
+async function runRepoCommand(repositoryInput, jsonOutput) {
+    const { owner, repo } = parseRepository(repositoryInput);
+    const metadata = await (0, github_1.fetchRepositoryMetadata)(owner, repo);
+    if (jsonOutput) {
+        const payload = {
+            repository: metadata.fullName,
+            size_mb: (0, size_1.kbToMbRounded)(metadata.sizeKb),
+            stars: metadata.stargazersCount,
+            language: metadata.language ?? "Unknown"
+        };
+        console.log(JSON.stringify(payload, null, 2));
+        return;
+    }
+    console.log(`Repository: ${metadata.fullName}`);
+    console.log(`Size: ${(0, size_1.formatSizeFromKb)(metadata.sizeKb)}`);
+    console.log(`Stars: ${(0, size_1.formatStars)(metadata.stargazersCount)}`);
+    console.log(`Language: ${metadata.language ?? "Unknown"}`);
+}
+function truncate(value, maxWidth) {
+    if (value.length <= maxWidth) {
+        return value;
+    }
+    if (maxWidth <= 1) {
+        return value.slice(0, maxWidth);
+    }
+    return `${value.slice(0, maxWidth - 1)}…`;
+}
+function renderOrgTable(rows) {
+    const headers = ["Repository", "Size", "Stars", "Language"];
+    const repositoryWidth = Math.min(48, Math.max(headers[0].length, ...rows.map((row) => truncate(row.repository, 48).length)));
+    const sizeWidth = Math.max(headers[1].length, ...rows.map((row) => (0, size_1.formatSizeFromKb)(row.size_mb * 1024).length));
+    const starsWidth = Math.max(headers[2].length, ...rows.map((row) => (0, size_1.formatStars)(row.stars).length));
+    const languageWidth = Math.max(headers[3].length, ...rows.map((row) => row.language.length));
+    const border = `+-${"-".repeat(repositoryWidth)}-+-${"-".repeat(sizeWidth)}-+-${"-".repeat(starsWidth)}-+-${"-".repeat(languageWidth)}-+`;
+    const headerRow = `| ${headers[0].padEnd(repositoryWidth)} | ${headers[1].padEnd(sizeWidth)} | ${headers[2].padEnd(starsWidth)} | ${headers[3].padEnd(languageWidth)} |`;
+    const bodyRows = rows.map((row) => {
+        const repository = truncate(row.repository, repositoryWidth).padEnd(repositoryWidth);
+        const size = (0, size_1.formatSizeFromKb)(row.size_mb * 1024).padEnd(sizeWidth);
+        const stars = (0, size_1.formatStars)(row.stars).padEnd(starsWidth);
+        const language = row.language.padEnd(languageWidth);
+        return `| ${repository} | ${size} | ${stars} | ${language} |`;
+    });
+    return [border, headerRow, border, ...bodyRows, border].join("\n");
+}
+function buildPayload(repositoryInput, metadata) {
+    return {
+        repository: metadata.fullName || repositoryInput,
+        size_mb: (0, size_1.kbToMbRounded)(metadata.sizeKb),
+        stars: metadata.stargazersCount,
+        language: metadata.language ?? "Unknown"
+    };
+}
+async function runRepositoriesCommand(repositoryInputs, jsonOutput) {
+    const effectiveInputs = repositoryInputs.length > 0
+        ? repositoryInputs
+        : [(0, git_1.detectCurrentRepositoryFromGitRemote)()];
+    const results = await Promise.all(effectiveInputs.map(async (input) => {
+        const { owner, repo } = parseRepository(input);
+        const metadata = await (0, github_1.fetchRepositoryMetadata)(owner, repo);
+        return buildPayload(input, metadata);
+    }));
+    if (jsonOutput) {
+        console.log(JSON.stringify(results.length === 1 ? results[0] : results, null, 2));
+        return;
+    }
+    for (const result of results) {
+        console.log(`Repository: ${result.repository}`);
+        console.log(`Size: ${(0, size_1.formatSizeFromKb)(result.size_mb * 1024)}`);
+        console.log(`Stars: ${(0, size_1.formatStars)(result.stars)}`);
+        console.log(`Language: ${result.language}`);
+        console.log("");
+    }
+}
+async function runOrganizationCommand(organization, jsonOutput, limit) {
+    const repositories = await (0, github_1.fetchOrganizationRepositories)(organization, limit);
+    const payload = repositories
+        .map((repo) => ({
+        repository: repo.fullName,
+        size_mb: (0, size_1.kbToMbRounded)(repo.sizeKb),
+        stars: repo.stargazersCount,
+        language: repo.language ?? "Unknown"
+    }))
+        .sort((a, b) => b.size_mb - a.size_mb);
+    if (jsonOutput) {
+        console.log(JSON.stringify(payload, null, 2));
+        return;
+    }
+    console.log(`Organization: ${organization}`);
+    console.log(`Repositories scanned: ${payload.length}`);
+    console.log("");
+    console.log(renderOrgTable(payload));
+}

package/dist/src/services/github.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchRepositoryMetadata = fetchRepositoryMetadata;
+exports.fetchOrganizationRepositories = fetchOrganizationRepositories;
+function createHeaders(token) {
+    const headers = {
+        Accept: "application/vnd.github+json",
+        "User-Agent": "reposizer-cli"
+    };
+    if (token) {
+        headers.Authorization = `Bearer ${token}`;
+    }
+    return headers;
+}
+function getErrorMessage(status) {
+    if (status === 404) {
+        return "Repository not found. Check the owner/repo value.";
+    }
+    if (status === 401 || status === 403) {
+        return "GitHub API access denied. Verify GITHUB_TOKEN or rate limits.";
+    }
+    return `GitHub API returned status ${status}.`;
+}
+async function fetchRepositoryMetadata(owner, repo, token = process.env.GITHUB_TOKEN) {
+    const endpoint = `https://api.github.com/repos/${encodeURIComponent(owner)}/${encodeURIComponent(repo)}`;
+    let response;
+    try {
+        response = await fetch(endpoint, {
+            method: "GET",
+            headers: createHeaders(token),
+            signal: AbortSignal.timeout(5000)
+        });
+    }
+    catch {
+        throw new Error("Unable to reach GitHub API. Check your network and try again.");
+    }
+    if (!response.ok) {
+        throw new Error(getErrorMessage(response.status));
+    }
+    const data = (await response.json());
+    return {
+        fullName: data.full_name,
+        sizeKb: data.size,
+        stargazersCount: data.stargazers_count,
+        language: data.language
+    };
+}
+async function fetchOrganizationRepositories(org, limit = 30, token = process.env.GITHUB_TOKEN) {
+    const safeLimit = Math.max(1, Math.min(limit, 100));
+    const endpoint = `https://api.github.com/orgs/${encodeURIComponent(org)}/repos?per_page=${safeLimit}&sort=updated&direction=desc`;
+    let response;
+    try {
+        response = await fetch(endpoint, {
+            method: "GET",
+            headers: createHeaders(token),
+            signal: AbortSignal.timeout(7000)
+        });
+    }
+    catch {
+        throw new Error("Unable to reach GitHub API. Check your network and try again.");
+    }
+    if (!response.ok) {
+        if (response.status === 404) {
+            throw new Error("Organization not found.");
+        }
+        throw new Error(getErrorMessage(response.status));
+    }
+    const data = (await response.json());
+    return data
+        .filter((repo) => !repo.archived && !repo.disabled)
+        .map((repo) => ({
+        fullName: repo.full_name,
+        sizeKb: repo.size,
+        stargazersCount: repo.stargazers_count,
+        language: repo.language
+    }));
+}

package/dist/src/utils/git.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectCurrentRepositoryFromGitRemote = detectCurrentRepositoryFromGitRemote;
+const node_child_process_1 = require("node:child_process");
+function parseRemoteToOwnerRepo(remoteUrl) {
+    const normalized = remoteUrl.trim().replace(/\.git$/, "");
+    const sshMatch = /^git@github\.com:([^/]+)\/([^/]+)$/.exec(normalized);
+    if (sshMatch) {
+        return `${sshMatch[1]}/${sshMatch[2]}`;
+    }
+    const httpsMatch = /^https:\/\/github\.com\/([^/]+)\/([^/]+)$/.exec(normalized);
+    if (httpsMatch) {
+        return `${httpsMatch[1]}/${httpsMatch[2]}`;
+    }
+    return null;
+}
+function detectCurrentRepositoryFromGitRemote() {
+    let remoteUrl = "";
+    try {
+        remoteUrl = (0, node_child_process_1.execFileSync)("git", ["remote", "get-url", "origin"], {
+            encoding: "utf8",
+            timeout: 2000,
+            stdio: ["ignore", "pipe", "ignore"]
+        }).trim();
+    }
+    catch {
+        throw new Error("No repository argument provided and no git origin remote was detected.");
+    }
+    const ownerRepo = parseRemoteToOwnerRepo(remoteUrl);
+    if (!ownerRepo) {
+        throw new Error("Unable to parse git remote. Expected a GitHub origin remote URL.");
+    }
+    return ownerRepo;
+}

package/dist/src/utils/size.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatSizeFromKb = formatSizeFromKb;
+exports.kbToMbRounded = kbToMbRounded;
+exports.formatStars = formatStars;
+function formatSizeFromKb(sizeKb) {
+    const sizeMb = sizeKb / 1024;
+    if (sizeMb < 1024) {
+        return `${sizeMb.toFixed(2)} MB`;
+    }
+    const sizeGb = sizeMb / 1024;
+    return `${sizeGb.toFixed(2)} GB`;
+}
+function kbToMbRounded(sizeKb) {
+    return Number((sizeKb / 1024).toFixed(2));
+}
+function formatStars(value) {
+    if (value >= 1000) {
+        return `${Math.round((value / 1000) * 10) / 10}k`;
+    }
+    return String(value);
+}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "reposizer",
+  "version": "0.1.0",
+  "description": "Fast CLI to inspect GitHub repository sizes",
+  "license": "MIT",
+  "author": "Hanif",
+  "type": "commonjs",
+  "bin": {
+    "reposizer": "dist/bin/reposizer.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsx bin/reposizer.ts",
+    "check": "tsc --noEmit -p tsconfig.json"
+  },
+  "keywords": [
+    "cli",
+    "github",
+    "repository",
+    "size",
+    "typescript"
+  ],
+  "dependencies": {
+    "commander": "^12.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.13.10",
+    "tsx": "^4.19.3",
+    "typescript": "^5.8.2"
+  },
+  "main": "index.js",
+  "directories": {
+    "doc": "docs"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Hanif-adedotun/reposizer.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Hanif-adedotun/reposizer/issues"
+  },
+  "homepage": "https://github.com/Hanif-adedotun/reposizer#readme"
+}