git0 0.3.17 → 0.3.18

package/docs/content/docs/index.mdx

@@ -0,0 +1,98 @@
+---
+title: Introduction
+description: Download Git Repo on Step Zero — search GitHub, download source & releases, install dependencies and open your editor.
+---
+
+![git0](https://i.imgur.com/RLXLAzY.png)
+
+[![npm version](https://img.shields.io/npm/v/git0.svg)](https://www.npmjs.com/package/git0) [![Discord](https://img.shields.io/discord/1110227955554209923.svg?label=Chat&logo=Discord&colorB=7289da&style=flat)](https://discord.gg/SJdBqBz3tV) [![GitHub Stars](https://img.shields.io/github/stars/OpenSourceAGI/dev-tools-starter-agent)](https://github.com/OpenSourceAGI/dev-tools-starter-agent) [![GitHub Discussions](https://img.shields.io/github/discussions/OpenSourceAGI/dev-tools-starter-agent)](https://github.com/OpenSourceAGI/dev-tools-starter-agent/discussions) ![PRs welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)  
+
+CLI tool to search GitHub repositories, download source & releases for your system, and instantly set up, then install dependencies and open code editor.
+
+## 🚀 Installation
+
+```bash
+npm install -g git0
+```
+
+```bash
+bun install -g git0
+```
+
+![livepreview](https://i.imgur.com/Io3ukRC.gif)
+![preview](https://i.imgur.com/K22NiBq.png)
+
+## ✨ Features
+
+- **Search GitHub repositories** by name with fuzzy matching
+- **Download repositories** directly from GitHub URLs or owner/repo shortcuts. Skip the manual git clone, cd, install dance
+- **Get Releases** instantly download latest release for your system or all systems
+- **Automatic dependency installation** and installation for multiple project types
+- **Smart IDE integration** - automatically opens projects in your preferred editor
+- **Cross-platform support** - works on Windows, macOS, and Linux
+- **Conflict resolution** - handles directory naming conflicts automatically
+- **Faster than git** - skips `.git` history and uncompresses while downloading
+
+## 🎯 Usage
+
+```bash
+
+# Direct download from GitHub URL
+## g and git0 both work
+g https://github.com/facebook/react
+
+# Search for repositories by name
+g react starter
+
+# Download using owner/repo shorthand
+git0 facebook/react
+
+# Use git0 without installing, (only node needed)
+# (copy this line into your project's readme to help others setup)
+npx git0 facebook/react
+```
+
+### Supported Project Types
+
+git0 automatically detects and sets up the following project types:
+
+| Project Type | Detection | Installation |
+|-------------|-----------|-------------|
+| **Node.js** | `package.json` | `bun install` (fallback to `npm install`) |
+| **Docker** | `Dockerfile`, `docker-compose.yml` | `docker-compose up -d` or `docker build` |
+| **Python** | `requirements.txt`, `setup.py` | Virtual environment + pip install |
+| **Rust** | `Cargo.toml` | `cargo build` |
+| **Go** | `go.mod` | `go mod tidy` |
+
+### Supported IDEs
+
+git0 automatically detects and opens projects in your preferred IDE:
+
+- **Cursor** (`cursor`)
+- **Windsurf** (`windsurf`) 
+- **VS Code** (`code`)
+- **Code Server** (`code-server`)
+- **Neovim** (`nvim`)
+- **Webstorm** (`webstorm`)
+
+## 🔧 Configuration
+
+### What Happens After Download
+
+1. **Repository is downloaded** to your current directory
+2. **Project type is detected** automatically
+3. **Dependencies are installed** based on project type
+4. **IDE is launched** automatically (if available)
+5. **Development server starts** (for Node.js projects)
+
+If a directory with the same name exists, git0 automatically appends a number (e.g., `react-2`, `react-3`).
+
+### GitHub Token (Optional)
+
+For higher API rate limits, set [your GitHub token](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens#creating-a-fine-grained-personal-access-token):
+
+```bash
+export GITHUB_TOKEN=your_github_token_here
+```
+
+Without a token, you're limited to 60 requests per hour. With a token, you get 5,000 requests per hour.

package/docs/content/docs/meta.json

@@ -0,0 +1,15 @@
+{
+  "title": "git0",
+  "description": "Download Git Repo on Step Zero",
+  "icon": "Book",
+  "root": true,
+  "pages": [
+    "---Getting Started---",
+    "index",
+    "---API Reference---",
+    "modules",
+    "git0",
+    "github-api",
+    "fm"
+  ]
+}

package/docs/content/docs/modules.mdx

@@ -0,0 +1,10 @@
+---
+title: Modules
+description: Index of the git0 source modules.
+---
+
+## Modules
+
+- [fm](/docs/fm)
+- [git0](/docs/git0)
+- [github-api](/docs/github-api)

package/docs/lib/fumadocs/customize-docs.ts

@@ -0,0 +1,47 @@
+/**
+ * @file customize-docs.ts
+ * @description Documentation configuration object and types.
+ */
+export const docsConfig: DocsConfig = {
+  title: "git0",
+  description: "Download Git Repo on Step Zero — search GitHub, download source & releases, install and open in your editor.",
+  github: "https://github.com/OpenSourceAGI/dev-tools-starter-agent/tree/master/packages/git0-repo-downloader",
+  githubPackages: "https://github.com/OpenSourceAGI/dev-tools-starter-agent/tree/master/packages",
+  githubDocs:
+    "https://github.com/OpenSourceAGI/dev-tools-starter-agent/tree/master/packages/git0-repo-downloader/docs/content/docs",
+  favicon: "/favicon.ico",
+  topLinks: [
+    {
+      text: "Docs",
+      url: "/docs",
+    },
+    {
+      text: "GitHub",
+      url: "https://github.com/OpenSourceAGI/dev-tools-starter-agent/tree/master/packages/git0-repo-downloader",
+      external: true,
+    },
+  ],
+};
+
+export interface DocsConfig {
+  /** The title of the documentation site */
+  title?: string;
+  /** A short description of the project */
+  description?: string;
+  /** URL to the GitHub repository */
+  github?: string;
+  /** Base URL for editing the docs pages on GitHub */
+  githubDocs?: string;
+  /** Base URL for the packages directory on GitHub */
+  githubPackages?: string;
+  /** Path to the favicon */
+  favicon?: string;
+  /** Path to the OpenAPI specification file */
+  apiDocsPath?: string;
+  /** Links to be displayed in the navigation bar */
+  topLinks?: {
+    text: string;
+    url: string;
+    external?: boolean;
+  }[];
+}

package/docs/lib/fumadocs/generate-api-docs.ts

@@ -0,0 +1,73 @@
+/**
+ * @file generate-api-docs.ts
+ * @description Script to generate API documentation files from an OpenAPI specification.
+ */
+import { generateFiles } from 'fumadocs-openapi';
+import { createOpenAPI } from 'fumadocs-openapi/server';
+import { rimraf } from 'rimraf';
+import { existsSync } from 'fs';
+import { docsConfig } from './customize-docs'
+
+const out = 'content/docs/(api)';
+
+
+async function generate(openapiPath: string | undefined) {
+  // Validate file exists
+  if (!openapiPath || !existsSync(openapiPath)) {
+    console.error(`Error: OpenAPI file not found${openapiPath ? ` at "${openapiPath}"` : ''}`);
+    process.exit(1);
+  }
+
+  // Use relative path for glob resolution
+  console.log(`Generating API docs from: ${openapiPath}`);
+
+  // clean generated files
+  await rimraf(out, {
+    filter(v) {
+      return !v.endsWith('index.mdx') && !v.endsWith('meta.json');
+    },
+  });
+
+  // Create OpenAPI instance (required for fumadocs-openapi v10+)
+  const openapi = createOpenAPI({
+    input: [openapiPath],
+  });
+
+  await generateFiles({
+    input: openapi,
+    output: out,
+    includeDescription: true,
+
+    // Or disable comments
+    addGeneratedComment: false,
+    frontmatter: (title, description) => ({
+      description: ''
+    }),
+    // index: {
+    //   // for generating `href`
+    //   url: {
+    //     baseUrl: '/docs/api',
+    //     contentDir: './content/docs/api',
+    //   },
+    //   items: [
+    //     {
+    //       path: 'api.mdx',
+    //       description: 'All available pages',
+    //     },
+    //   ],
+    // },
+
+  });
+
+  console.log(`API documentation generated successfully in: ${out}`);
+}
+
+// Parse command line arguments
+const args = process.argv.slice(2);
+
+const openapiPath = args[0] || docsConfig.apiDocsPath;
+if (!openapiPath) {
+    console.error('Error: OpenAPI file path not provided');
+    process.exit(1);
+}
+void generate(openapiPath);

package/docs/lib/fumadocs/source.tsx

@@ -0,0 +1,50 @@
+/**
+ * @file source.tsx
+ * @description Fumadocs source loader configuration and page structure.
+ */
+import { docs } from 'fumadocs-mdx:collections/server'
+import {
+  type InferMetaType,
+  type InferPageType,
+  type LoaderPlugin,
+  loader,
+} from 'fumadocs-core/source'
+import { lucideIconsPlugin } from 'fumadocs-core/source/lucide-icons'
+import { openapiPlugin } from 'fumadocs-openapi/server'
+
+export const source = loader({
+  baseUrl: '/docs',
+  plugins: [pageTreeCodeTitles(), lucideIconsPlugin(), openapiPlugin()],
+  source: docs.toFumadocsSource(),
+})
+
+function pageTreeCodeTitles(): LoaderPlugin {
+  return {
+    transformPageTree: {
+      file(node) {
+        if (
+          typeof node.name === 'string' &&
+          (node.name.endsWith('()') || node.name.match(/^<\w+ \/>$/))
+        ) {
+          return {
+            ...node,
+            name: <code className='text-[0.8125rem]'>{node.name}</code>,
+          }
+        }
+        return node
+      },
+    },
+  }
+}
+
+
+export async function getLLMText(page: InferPageType<typeof source>) {
+  const processed = await page.data.getText('processed');
+
+  return `# ${page.data.title} (${page.url})
+
+${processed}`;
+}
+
+export type Page = InferPageType<typeof source>
+export type Meta = InferMetaType<typeof source>

package/docs/lib/utils.ts

@@ -0,0 +1,10 @@
+/**
+ * @file utils.ts
+ * @description General utility functions for the documentation site.
+ */
+import { clsx, type ClassValue } from 'clsx'
+import { twMerge } from 'tailwind-merge'
+
+export function cn(...inputs: ClassValue[]) {
+  return twMerge(clsx(inputs))
+}

package/docs/mdx-components.tsx

@@ -0,0 +1,21 @@
+
+import * as TabsComponents from 'fumadocs-ui/components/tabs';
+import { File, Folder, Files } from 'fumadocs-ui/components/files';
+import defaultComponents from 'fumadocs-ui/mdx';
+import { APIPage } from '@/components/fumadocs/api/api-page';
+import type { MDXComponents } from 'mdx/types';
+// make sure you can use it in MDX files
+
+
+export function getMDXComponents(components?: MDXComponents): MDXComponents {
+  return {
+    ...TabsComponents,
+    ...defaultComponents,
+    // @ts-ignore
+    APIPage,
+    File,
+    Folder,
+    Files,
+    ...components,
+  };
+}

package/docs/next-env.d.ts

@@ -0,0 +1,7 @@
+/// <reference types="next" />
+/// <reference types="next/image-types/global" />
+import "./.next/types/routes.d.ts";
+import "./.next/types/root-params.d.ts";
+
+// NOTE: This file should not be edited
+// see https://nextjs.org/docs/app/api-reference/config/typescript for more information.

package/docs/next.config.ts

@@ -0,0 +1,35 @@
+import { createMDX } from 'fumadocs-mdx/next';
+import { resolve } from 'path';
+
+const withMDX = createMDX({});
+
+type MDXNextConfig = NonNullable<Parameters<typeof withMDX>[0]>;
+
+export const config = {
+  // output: 'export',
+  // distDir: './dist',
+  transpilePackages: ['code-graph'],
+  serverExternalPackages: [],
+  turbopack: {
+    root: resolve(import.meta.dirname, '.'),
+  },
+  async rewrites() {
+    return [
+      {
+        source: '/docs/:path*.mdx',
+        destination: '/docs/llms.mdx/docs/:path*',
+      },
+    ];
+  },
+  reactStrictMode: false,
+  images: {
+    remotePatterns: [
+      {
+        protocol: 'https',
+        hostname: 'i.imgur.com',
+      },
+    ],
+    unoptimized: true,
+  },
+} satisfies MDXNextConfig;
+export default withMDX(config);

package/docs/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "git0-docs",
+  "description": "git0 documentation site (git0.js.org), built on template-fumadocs",
+  "version": "1.0.0",
+  "private": true,
+  "scripts": {
+    "dev": "rm -rf .next/; open-ready next dev  --turbo",
+    "build": "next build",
+    "build:preview": "next build; open-ready next start",
+    "build:api": "node ./lib/fumadocs/generate-api-docs.ts",
+    "check": "fumadocs-mdx && tsc --noEmit",
+    "favicon": "npm create favicon public/favicon-512.png public/ -- --overwrite"
+  },
+  "dependencies": {
+    "@fumadocs/mdx-remote": "^1.4.3",
+    "@next/swc-linux-x64-gnu": "^16.2.10",
+    "@radix-ui/react-collapsible": "^1.1.12",
+    "@radix-ui/react-dialog": "^1.1.15",
+    "@radix-ui/react-slot": "^1.2.4",
+    "@radix-ui/react-tooltip": "^1.2.8",
+    "@typescript-eslint/typescript-estree": "^8.56.1",
+    "class-variance-authority": "^0.7.1",
+    "clsx": "^2.1.1",
+    "fumadocs-core": "^16.11.5",
+    "fumadocs-mdx": "^15.2.0",
+    "fumadocs-openapi": "^11.2.2",
+    "fumadocs-typescript": "^4.0.13",
+    "fumadocs-ui": "^16.11.5",
+    "fuse.js": "^7.1.0",
+    "highlight.js": "^11.11.1",
+    "jszip": "^3.10.1",
+    "lucide-react": "^0.555.0",
+    "marked": "^17.0.4",
+    "mermaid": "^11.12.3",
+    "next": "^16.1.4",
+    "next-themes": "^0.4.6",
+    "react": "^19.2.7",
+    "react-dom": "^19.2.7",
+    "shadcn-theme-menu": "^1.1.12",
+    "shiki": "^3.17.0",
+    "svg-toolbelt": "^0.6.1",
+    "tailwind-merge": "^3.5.0",
+    "tw-animate-css": "^1.4.0",
+    "zbsearch": "^4.0.0"
+  },
+  "devDependencies": {
+    "@tailwindcss/postcss": "^4.1.17",
+    "@types/jszip": "^3.4.1",
+    "@types/mdx": "^2.0.13",
+    "@types/node": "24.10.1",
+    "@types/react": "^19.2.7",
+    "@types/react-dom": "^19.2.3",
+    "baseline-browser-mapping": "^2.8.32",
+    "open-ready": "^0.1.2",
+    "postcss": "^8.5.6",
+    "rimraf": "^6.1.2",
+    "tailwindcss": "^4.1.17",
+    "typescript": "^5.9.3",
+    "wrangler": "^3.0.0"
+  }
+}

package/docs/postcss.config.mjs

@@ -0,0 +1,5 @@
+export default {
+  plugins: {
+    '@tailwindcss/postcss': {},
+  },
+};

package/docs/public/manifest.webmanifest

@@ -0,0 +1,14 @@
+{
+  "icons": [
+    {
+      "src": "/favicon-192.png",
+      "type": "image/png",
+      "sizes": "192x192"
+    },
+    {
+      "src": "/favicon-512.png",
+      "type": "image/png",
+      "sizes": "512x512"
+    }
+  ]
+}

package/docs/source.config.ts

@@ -0,0 +1,29 @@
+import {
+  defineConfig,
+  defineDocs,
+  frontmatterSchema,
+  metaSchema,
+} from 'fumadocs-mdx/config';
+import { remarkMdxFiles } from 'fumadocs-core/mdx-plugins/remark-mdx-files';
+
+export const docs = defineDocs({
+  dir: './content/docs',
+  docs: {
+    schema: frontmatterSchema,
+    postprocess: {
+      includeProcessedMarkdown: true,
+    },
+  },
+  meta: {
+    schema: metaSchema,
+  },
+});
+
+export default defineConfig({
+  mdxOptions: {
+    remarkPlugins: [remarkMdxFiles],
+    remarkImageOptions: {
+      onError: 'ignore',
+    },
+  },
+});

package/docs/tsconfig.json

@@ -0,0 +1,50 @@
+{
+  "compilerOptions": {
+    "target": "ESNext",
+    "lib": [
+      "dom",
+      "dom.iterable",
+      "esnext"
+    ],
+    "allowJs": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "forceConsistentCasingInFileNames": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "react-jsx",
+    "incremental": true,
+    "paths": {
+      "@/*": [
+        "./*"
+      ],
+      "fumadocs-mdx:collections/*": [
+        "./.source/*"
+      ]
+    },
+    "plugins": [
+      {
+        "name": "next"
+      }
+    ]
+  },
+  "include": [
+    "**/*.ts",
+    "**/*.tsx",
+    "../docs/types/**/*.ts",
+    "./docs/types/**/*.ts",
+    ".next/types/**/*.ts",
+    "next-env.d.ts",
+    "./dist/types/**/*.ts",
+    "dist/types/**/*.ts",
+    "dist/dev/types/**/*.ts",
+    ".next/dev/types/**/*.ts"
+  ],
+  "exclude": [
+    "node_modules"
+  ]
+}

package/docs/vite.config.ts

@@ -0,0 +1,2 @@
+// Vite config not used for Next.js builds
+export default {};

package/docs/wrangler.jsonc

@@ -0,0 +1,13 @@
+{
+  "name": "git0-docs",
+  // Wrangler deletes plaintext Variables set in the Cloudflare dashboard on every
+  // deploy unless keep_vars is set. Secrets are never deleted either way.
+  "keep_vars": true,
+  "compatibility_date": "2025-01-01",
+  "compatibility_flags": ["nodejs_compat"],
+  "main": ".vinext/worker.js",
+  "assets": {
+    "directory": ".vinext/assets",
+    "binding": "ASSETS"
+  }
+}

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "git0",
     "description": "CLI tool to search GitHub repositories, download source & releases for your system, and instantly set up, then install dependencies and open code editor.",
-    "version": "0.3.17",
+    "version": "0.3.18",
     "author": "vtempest",
     "scripts": {
         "build": "bun build src/cli.ts --outdir dist --target node --format esm --sourcemap",