nogic 0.0.1__tar.gz

nogic-0.0.1/.claude/settings.local.json

@@ -0,0 +1,22 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(uv run:*)",
+      "Bash(uv add:*)",
+      "mcp__nogic__find_symbol",
+      "mcp__nogic__before_writing",
+      "mcp__nogic__get_file_structure",
+      "mcp__nogic__find_similar",
+      "mcp__nogic__find_by_framework",
+      "mcp__nogic__get_file_dependencies",
+      "mcp__nogic__find_tests",
+      "mcp__nogic__describe_project",
+      "mcp__nogic__list_files",
+      "mcp__nogic__get_conventions",
+      "mcp__nogic__get_dependencies",
+      "mcp__nogic__assess_impact",
+      "mcp__nogic__get_class_structure",
+      "mcp__nogic__get_references"
+    ]
+  }
+}

nogic-0.0.1/.gitignore

@@ -0,0 +1,39 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# Virtual environments
+.venv/
+venv/
+ENV/
+
+# Distribution / packaging
+dist/
+build/
+*.egg-info/
+*.egg
+
+# UV
+uv.lock
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+
+# Misc
+.DS_Store
+*.log
+
+.env.* 
+.env.example
+.env
+
+.nogic

nogic-0.0.1/.python-version

@@ -0,0 +1 @@
+3.11

nogic-0.0.1/DEVELOPMENT.md

@@ -0,0 +1,213 @@
+# Development Guide
+
+This guide covers setting up the development environment for contributing to the Nogic CLI.
+
+## Prerequisites
+
+- Python 3.11+
+- [UV](https://docs.astral.sh/uv/) package manager
+
+### Installing UV
+
+```bash
+# macOS/Linux
+curl -LsSf https://astral.sh/uv/install.sh | sh
+
+# Or with Homebrew
+brew install uv
+```
+
+## Setup
+
+### 1. Clone the repository
+
+```bash
+git clone https://github.com/nogic/cli.git
+cd cli
+```
+
+### 2. Install dependencies
+
+```bash
+uv sync
+```
+
+This creates a virtual environment in `.venv/` and installs all dependencies.
+
+### 3. Configure environment
+
+Copy the example environment file:
+
+```bash
+cp .env.example .env
+```
+
+Edit `.env` with your development settings:
+
+```bash
+NOGIC_API_URL=http://localhost:8000
+NOGIC_API_KEY=your-dev-api-key
+```
+
+## Running the CLI
+
+### Using UV (recommended)
+
+```bash
+uv run nogic --help
+uv run nogic hello world
+```
+
+### Using the virtual environment directly
+
+```bash
+source .venv/bin/activate
+python -m nogic.main --help
+```
+
+### As an editable install
+
+```bash
+uv pip install -e .
+nogic --help
+```
+
+## Project Structure
+
+```
+cli/
+├── src/nogic/
+│   ├── __init__.py          # Package version
+│   ├── main.py              # CLI entry point
+│   ├── config.py            # Configuration management
+│   ├── api/
+│   │   └── client.py        # Backend API client
+│   ├── commands/
+│   │   ├── hello.py         # Demo commands
+│   │   ├── login.py         # Authentication
+│   │   ├── projects.py      # Project management
+│   │   ├── init.py          # Project initialization
+│   │   ├── sync.py          # One-time sync
+│   │   └── watch.py         # File watcher
+│   └── watcher/
+│       ├── monitor.py       # Filesystem monitoring
+│       ├── storage.py       # SQLite file tracking
+│       └── sync.py          # Sync service
+├── pyproject.toml           # Package configuration
+├── uv.lock                  # Dependency lock file
+└── .env.example             # Environment template
+```
+
+## Adding a New Command
+
+1. Create a new file in `src/nogic/commands/`:
+
+```python
+# src/nogic/commands/mycommand.py
+import click
+
+@click.command()
+@click.argument("name", default="World")
+def mycommand(name: str):
+    """Description of my command."""
+    click.echo(f"Hello, {name}!")
+```
+
+2. Register it in `src/nogic/main.py`:
+
+```python
+from nogic.commands import mycommand
+
+cli.add_command(mycommand.mycommand)
+```
+
+3. Test the command:
+
+```bash
+uv run nogic mycommand --help
+```
+
+## Dependencies
+
+### Core Dependencies
+
+| Package | Purpose |
+|---------|---------|
+| `click` | CLI framework |
+| `watchdog` | Filesystem monitoring |
+| `httpx` | HTTP client |
+| `python-dotenv` | Environment configuration |
+
+### Adding Dependencies
+
+```bash
+uv add package-name
+```
+
+### Removing Dependencies
+
+```bash
+uv remove package-name
+```
+
+## Building
+
+### Build a wheel
+
+```bash
+uv build
+```
+
+Output will be in `dist/`.
+
+### Install from built wheel
+
+```bash
+uv pip install dist/nogic-*.whl
+```
+
+## Code Style
+
+- Follow PEP 8 guidelines
+- Use type hints where possible
+- Keep functions focused and small
+- Use Click's built-in error handling
+
+## Testing Commands Locally
+
+```bash
+# Test login flow
+uv run nogic login
+
+# Test project initialization
+uv run nogic init /tmp/test-project --name "Test"
+
+# Test file watching
+uv run nogic watch /tmp/test-project
+
+# Test sync
+uv run nogic sync /tmp/test-project
+```
+
+## Debugging
+
+### Enable verbose output
+
+Most commands will print status information. For debugging API calls, check the backend logs.
+
+### Check configuration
+
+```bash
+# View global config
+cat ~/.nogic/config.json
+
+# View project config
+cat .nogic/config.json
+```
+
+### Inspect the local database
+
+```bash
+sqlite3 .nogic/nogic.db ".tables"
+sqlite3 .nogic/nogic.db "SELECT * FROM files LIMIT 10;"
+```

nogic-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Nogic
+
+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.

nogic-0.0.1/PKG-INFO

@@ -0,0 +1,201 @@
+Metadata-Version: 2.4
+Name: nogic
+Version: 0.0.1
+Summary: Code intelligence CLI for AI agents — index, search, and understand codebases via graph + vector embeddings.
+Project-URL: Homepage, https://nogic.dev
+Project-URL: Repository, https://github.com/nogic-dev/cli
+Project-URL: Documentation, https://docs.nogic.dev
+Author-email: Nogic <support@nogic.dev>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: ai-agents,code-graph,code-intelligence,embeddings,mcp,tree-sitter
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Software Development :: Quality Assurance
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: pathspec>=0.12.0
+Requires-Dist: posthog>=3.0.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: tree-sitter-javascript>=0.23.0
+Requires-Dist: tree-sitter-python>=0.23.0
+Requires-Dist: tree-sitter-typescript>=0.23.0
+Requires-Dist: tree-sitter>=0.24.0
+Requires-Dist: typer>=0.12.0
+Requires-Dist: watchdog>=6.0.0
+Description-Content-Type: text/markdown
+
+# Nogic CLI
+
+Graph visualization for Developers and AI Agents.
+
+## Installation
+
+### Prerequisites
+
+- Python 3.11 or higher
+
+### Install from PyPI
+
+```bash
+pip install nogic
+```
+
+### Install from Source
+
+```bash
+git clone https://github.com/nogic/cli.git
+cd cli
+pip install .
+```
+
+## Quick Start
+
+### 1. Login with your API key
+
+```bash
+nogic login
+```
+
+You'll be prompted to enter your API key from the Nogic dashboard.
+
+### 2. Initialize a project
+
+```bash
+cd /path/to/your/project
+nogic init
+```
+
+This creates a `.nogic/` directory with project configuration.
+
+### 3. Sync your codebase
+
+One-time sync:
+
+```bash
+nogic sync
+```
+
+Or watch for continuous syncing:
+
+```bash
+nogic watch
+```
+
+## Commands
+
+### `nogic login`
+
+Authenticate with the Nogic API.
+
+```bash
+nogic login
+nogic login --api-key YOUR_API_KEY
+```
+
+### `nogic init`
+
+Initialize a project for Nogic tracking.
+
+```bash
+nogic init                           # Initialize current directory
+nogic init /path/to/project          # Initialize specific directory
+nogic init --name "My Project"       # Set project name
+nogic init --project-id UUID         # Use existing project ID
+```
+
+### `nogic sync`
+
+Perform a one-time full sync of your codebase.
+
+```bash
+nogic sync                           # Sync current directory
+nogic sync /path/to/project          # Sync specific directory
+nogic sync --ignore "*.log"          # Ignore specific patterns
+```
+
+### `nogic watch`
+
+Continuously monitor and sync file changes.
+
+```bash
+nogic watch                          # Watch current directory
+nogic watch /path/to/project         # Watch specific directory
+nogic watch --ignore "*.log"         # Ignore specific patterns
+```
+
+Press `Ctrl+C` to stop watching.
+
+### `nogic projects`
+
+Manage your Nogic projects.
+
+```bash
+nogic projects list                  # List all projects
+nogic projects create "Project Name" # Create new project
+nogic projects create "Name" --use   # Create and set as current
+nogic projects use PROJECT_ID        # Set current project
+```
+
+## Configuration
+
+### Environment Variables
+
+Create a `.env` file or set environment variables:
+
+```bash
+NOGIC_API_URL=http://localhost:8000  # Backend API URL
+NOGIC_API_KEY=your-api-key           # API key (alternative to login)
+```
+
+### Config Files
+
+- **Global config**: `~/.nogic/config.json` - Stores API key and telemetry preference
+- **Project config**: `.nogic/config.json` - Stores project ID
+
+## Telemetry
+
+Nogic collects anonymous usage data to improve the product. All data is anonymized.
+
+### Manage Telemetry
+
+```bash
+nogic telemetry status   # Check current status
+nogic telemetry disable  # Opt out
+nogic telemetry enable   # Opt back in
+```
+
+### Environment Variables
+
+```bash
+NOGIC_TELEMETRY_DISABLED=1  # Disable telemetry
+DO_NOT_TRACK=1              # Standard opt-out (also works)
+```
+
+### Default Ignore Patterns
+
+The following patterns are ignored by default:
+
+- `.git/`
+- `__pycache__/`
+- `node_modules/`
+- `.venv/`
+- `.nogic/`
+- `*.pyc`
+- `.DS_Store`
+
+Add custom patterns with the `--ignore` flag.
+
+## License
+
+MIT

nogic-0.0.1/README.md

@@ -0,0 +1,164 @@
+# Nogic CLI
+
+Graph visualization for Developers and AI Agents.
+
+## Installation
+
+### Prerequisites
+
+- Python 3.11 or higher
+
+### Install from PyPI
+
+```bash
+pip install nogic
+```
+
+### Install from Source
+
+```bash
+git clone https://github.com/nogic/cli.git
+cd cli
+pip install .
+```
+
+## Quick Start
+
+### 1. Login with your API key
+
+```bash
+nogic login
+```
+
+You'll be prompted to enter your API key from the Nogic dashboard.
+
+### 2. Initialize a project
+
+```bash
+cd /path/to/your/project
+nogic init
+```
+
+This creates a `.nogic/` directory with project configuration.
+
+### 3. Sync your codebase
+
+One-time sync:
+
+```bash
+nogic sync
+```
+
+Or watch for continuous syncing:
+
+```bash
+nogic watch
+```
+
+## Commands
+
+### `nogic login`
+
+Authenticate with the Nogic API.
+
+```bash
+nogic login
+nogic login --api-key YOUR_API_KEY
+```
+
+### `nogic init`
+
+Initialize a project for Nogic tracking.
+
+```bash
+nogic init                           # Initialize current directory
+nogic init /path/to/project          # Initialize specific directory
+nogic init --name "My Project"       # Set project name
+nogic init --project-id UUID         # Use existing project ID
+```
+
+### `nogic sync`
+
+Perform a one-time full sync of your codebase.
+
+```bash
+nogic sync                           # Sync current directory
+nogic sync /path/to/project          # Sync specific directory
+nogic sync --ignore "*.log"          # Ignore specific patterns
+```
+
+### `nogic watch`
+
+Continuously monitor and sync file changes.
+
+```bash
+nogic watch                          # Watch current directory
+nogic watch /path/to/project         # Watch specific directory
+nogic watch --ignore "*.log"         # Ignore specific patterns
+```
+
+Press `Ctrl+C` to stop watching.
+
+### `nogic projects`
+
+Manage your Nogic projects.
+
+```bash
+nogic projects list                  # List all projects
+nogic projects create "Project Name" # Create new project
+nogic projects create "Name" --use   # Create and set as current
+nogic projects use PROJECT_ID        # Set current project
+```
+
+## Configuration
+
+### Environment Variables
+
+Create a `.env` file or set environment variables:
+
+```bash
+NOGIC_API_URL=http://localhost:8000  # Backend API URL
+NOGIC_API_KEY=your-api-key           # API key (alternative to login)
+```
+
+### Config Files
+
+- **Global config**: `~/.nogic/config.json` - Stores API key and telemetry preference
+- **Project config**: `.nogic/config.json` - Stores project ID
+
+## Telemetry
+
+Nogic collects anonymous usage data to improve the product. All data is anonymized.
+
+### Manage Telemetry
+
+```bash
+nogic telemetry status   # Check current status
+nogic telemetry disable  # Opt out
+nogic telemetry enable   # Opt back in
+```
+
+### Environment Variables
+
+```bash
+NOGIC_TELEMETRY_DISABLED=1  # Disable telemetry
+DO_NOT_TRACK=1              # Standard opt-out (also works)
+```
+
+### Default Ignore Patterns
+
+The following patterns are ignored by default:
+
+- `.git/`
+- `__pycache__/`
+- `node_modules/`
+- `.venv/`
+- `.nogic/`
+- `*.pyc`
+- `.DS_Store`
+
+Add custom patterns with the `--ignore` flag.
+
+## License
+
+MIT