open-index/open-npm huggingface dataset:
npm package: @notes-sync/cli
Description: CLI for AI-powered note synchronization
Author: Logan Spencer
Latest version: 1.1.17

# @notes-sync/cli

Command-line interface for Notes Sync - AI-powered note synchronization with Git backup.

## Overview

This CLI tool allows you to:

- Add notes and todos from anywhere in your terminal
- Search through your notes with context
- Manage todos (complete, delete, archive)
- Format and organize your notes
- Create daily sections with AI-generated quotes
- Sync your notes to Git automatically

## Installation

```bash
# Install CLI globally
npm install -g @notes-sync/cli

# The CLI will guide you through service setup
notes-sync status
```

## Key Commands

```bash
# Service management
notes-sync status            # Check service status
notes-sync install           # Install background service
notes-sync stop              # Stop the service
notes-sync upgrade           # Upgrade CLI and service

# Content management
notes-sync add -n "New note" # Add note
notes-sync add -t "New todo" # Add todo
notes-sync search "query"    # Search notes
notes-sync view --today      # View today's notes

# Todo management
notes-sync mark-complete     # Mark todos as done (interactive)
notes-sync delete            # Delete todos (interactive)
notes-sync incomplete-todos  # Show pending todos

# Document management
notes-sync format            # Clean up formatting
notes-sync daily --create    # Create today's section
```

## AI Integration

```bash
# Ask AI about your notes
notes-sync ai query "What should I focus on next?"
notes-sync ai query --week "How productive was I?"
```

## Documentation

For full documentation, visit the [Notes Sync GitHub repository](https://github.com/yourusername/notes-sync).

## License

MIT
npm package: @notes-sync/service
Description: Background service for AI-powered note synchronization
Author: Logan Spencer
Latest version: 1.1.17

# @notes-sync/service

Background service for Notes Sync - AI-powered note synchronization with Git backup.

## Overview

This package provides a background service that:

- Watches your notes directory for changes
- Automatically commits and pushes to Git
- Provides an HTTP API for the CLI to interact with
- Creates daily note sections with AI-generated quotes
- Handles file formatting and organization

## Installation

```bash
# Install globally
npm install -g @notes-sync/service

# Install as background service
notes-sync install
```

## Usage

### Start Service

```bash
# Start manually (foreground)
notes-sync-service

# Start as background service
notes-sync-service start
```

### Command Line

The service is designed to be used with the CLI package:

```bash
npm install -g @notes-sync/cli
notes-sync status
```

### Configuration

Create a config file at `~/.config/notes-sync/config.json`:

```json
{
  "notesDir": "/path/to/your/notes",
  "notesFile": "Daily.md",
  "server": {
    "host": "127.0.0.1",
    "port": 3127
  },
  "autoCreateDaily": true
}
```

**Interactive Setup**: The easiest way to configure is through the CLI:

```bash
notes-sync install
```

This will detect existing markdown files and ask if you want to use them.

## API Endpoints

The service exposes HTTP endpoints on port 3127:

- `GET /status` - Service health and info
- `POST /sync` - Trigger manual sync
- `POST /add-note` - Add note to today's section
- `POST /add-todo` - Add todo to today's focus
- And many more...

## Documentation

For full documentation, visit the [Notes Sync GitHub repository](https://github.com/yourusername/notes-sync).

## License

MIT
npm package: @notes-sync/shared
Description: Shared types and utilities for notes-sync
Author: Logan Spencer
Latest version: 1.1.17

# @notes-sync/shared

Shared types and API client for Notes Sync - an AI-powered note synchronization system.

## Overview

This package contains:

- TypeScript interfaces for API communication
- API client for interacting with the Notes Sync service
- Shared types for consistent data contracts across packages

## Installation

```bash
npm install @notes-sync/shared
```

## Usage

```typescript
import { ApiClient } from '@notes-sync/shared';

// Create client instance
const client = new ApiClient('http://localhost:3127');

// Use client methods
const status = await client.getStatus();
console.log(`Service running: ${status.running}`);

// Add note or todo
await client.addNote('Meeting notes from today');
await client.addTodo('Follow up with team');

// Search notes
const results = await client.searchNotes({ query: 'meeting', daysBack: 7 });
```

## Types

```typescript
// Use shared types in your code
import { ServiceStatus, SearchNotesResponse } from '@notes-sync/shared';
```

## Documentation

For full documentation, visit the [Notes Sync GitHub repository](https://github.com/yourusername/notes-sync).

## License

MIT