fetch-prompts

Fetch prompts from a public GitLab repository.

Quick Start

Simple - no authentication required!

npx -y @naganpm/fetch-prompts

This downloads all .md prompt files from https://gitlab.com/prompts4/prompt-manager into a local prompts/ folder.

Alternative: For Private Repos

If the GitLab repo becomes private, users will need:

1. Access to the GitLab repo (ask owner to add you as member)
2. A GitLab personal access token

Step 1: Get Added to GitLab Repo

Ask the repo owner to add you at: https://gitlab.com/prompts4/prompt-manager/-/project_members

Step 2: Create GitLab Token

1. Go to: https://gitlab.com/-/profile/personal_access_tokens
2. Create token with scopes: read_api, read_repository
3. Copy your token (starts with glpat-)

Step 3: Run with Token

GITLAB_TOKEN=glpat-your-token-here npx -y @naganpm/fetch-prompts

Or export it first:

export GITLAB_TOKEN=glpat-your-token-here
npx -y @naganpm/fetch-prompts

For Repo Owner: Adding Users (Private Repos Only)

To grant someone access to fetch prompts:

1. Go to: https://gitlab.com/prompts4/prompt-manager/-/project_members
2. Click "Invite members"
3. Add their GitLab username or email
4. Set role to "Reporter" (read-only access)
5. Click "Invite"

They can then create their own token and use the npx command above.

Setup (For Development)

If you want to fork/modify this package:

1. Edit bin/index.js to point to your GitLab repo:

   const GITLAB_PROJECT = 'your-group/your-project';
   const GITLAB_BRANCH = 'main';
   const PROMPTS_PATH = 'prompts';

2. Create .env for local testing:

   # Copy the example
   cp .env.example .env
      
   # Edit .env and add your GitLab token
   GITLAB_TOKEN=glpat-xxxxxxxxxxxx

   Create a token at: https://gitlab.com/-/profile/personal_access_tokens Required scopes: read_api, read_repository

3. Prepare your GitLab repo with a prompts/ folder containing .md files:

   your-gitlab-repo/
   └── prompts/
       ├── assessments-result-feed.md
       └── other-prompt.md

4. Test locally:

# Install dependencies
npm install

# Make bin/index.js executable
chmod +x bin/index.js

# Create .env with your token (for private repos)
cp .env.example .env
# Edit .env and add your GITLAB_TOKEN

# Test locally
npm link
npx -y @naganpm/fetch-prompts

# Or run directly
node bin/index.js

GitLab Repository Structure

Your GitLab repo should have:

prompts/
├── assessments-result-feed.md
├── another-route.md
└── more-prompts.md

All .md files in the prompts/ folder will be downloaded.