# Gitea .profile Repository

## ✅ Setup Complete!

Your `.profile` repository has been successfully created on Gitea with HTTPS authentication using a Personal Access Token (PAT).

### 📍 Repository Information

- **Repository Name:** `.profile`
- **User:** willow-ai
- **Full URL:** https://git.wholeworldcoding.com/willow-ai/.profile
- **Clone URL:** https://git.wholeworldcoding.com/willow-ai/.profile.git
- **Authentication:** Personal Access Token (PAT)
- **HTTPS:** ✅ Working

### 🔑 PAT Details

```
Token: d1da5d8c17a64d89afca0123c5b781073e69f9c1
Username: willow-ai
```

### 💻 Git Configuration

Configure git to remember your PAT:

```bash
# Clone the repository
git clone https://git.wholeworldcoding.com/willow-ai/.profile.git

# Configure git to store the token
git config --global credential.https.*.password d1da5d8c17a64d89afca0123c5b781073e69f9c1

# Verify setup
git remote -v
```

### 📝 First Push

```bash
cd /Users/stevensherry/.profile

# Configure git user (required for commits)
git config user.name "Willow"
git config user.email "willow@wholeworldcoding.com"

# Add and commit
git add .
git commit -m "Your commit message here"

# Push to Gitea
git push -u origin main
```

### 🔄 Clone and Pull

```bash
# Clone fresh copy
git clone https://git.wholeworldcoding.com/willow-ai/.profile.git

# Pull latest changes
cd .profile
git pull origin main

# Make changes
# edit files...

git add .
git commit -m "Your message"
git push origin main
```

### 🛠️ Helper Scripts

A helper script `git-auth` is available in `/scripts/git-auth` for automated git operations.

### 📁 Repository Structure

```
.profile/
├── README.md              # This file and initial Gitea docs
├── GITEA_SETUP.md        # Detailed Gitea API setup instructions
├── GITEA_README.md       # This file with quick start guide
├── scripts/
│   ├── git-auth          # Git authentication helper
│   └── git-gitea         # API-based git commands
└── .git/                 # Git repository
```

### 🌐 Access

- **Web UI:** https://git.wholeworldcoding.com/willow-ai/.profile
- **API:** https://git.wholeworldcoding.com/api/v1
- **GitHub Compatible URL:** https://git.wholeworldcoding.com/willow-ai/.profile.git

### 🧪 Testing HTTPS

```bash
# Test connection
export GITEA_TOKEN="d1da5d...f9c1"
curl -H "Authorization: Bearer $GITEA_TOKEN" \
     https://git.wholeworldcoding.com/api/v1/user/repos

# Should return JSON with repository info
```

### 📚 Documentation

- **GITEA_SETUP.md** - Comprehensive Gitea API guide
- **GITEA_README.md** - Quick start with this repository
- **scripts/git-gitea** - API-based git commands
- **test_gitea_https.sh** - Test script

### 🔒 Security

⚠️ **IMPORTANT:**
1. Never commit your PAT to version control
2. Don't share the token publicly
3. Store in `~/.gitea-token` (add to .gitignore)
4. Use environment variable: `export GITEA_TOKEN="..."`

```bash
# Good practice
echo "d1da5d8c17a64d89afca0123c5b781073e69f9c1" > ~/.gitea-token
chmod 600 ~/.gitea-token

# Use in scripts
source ~/.gitea-token
export GITEA_TOKEN=$GITEA_TOKEN
```

### 🎯 API Rate Limits

- **Authenticated users:** 5000 requests per hour
- **Check limits:** `curl -H "Authorization: Bearer..." api/ratelimit`
- **Headers in responses:** `X-RateLimit-Remaining`

### 📖 Quick API Reference

```bash
# List my repos
curl -H "Authorization: Bearer YOUR_TOKEN" https://git.wholeworldcoding.com/api/v1/user/repos

# Get repo info
curl -H "Authorization: Bearer YOUR_TOKEN" https://git.wholeworldcoding.com/api/v1/repos/willow-ai/.profile

# List contents
curl -H "Authorization: Bearer YOUR_TOKEN" https://git.wholeworldcoding.com/api/v1/repos/willow-ai/.profile/contents

# List commits
curl -H "Authorization: Bearer YOUR_TOKEN" https://git.wholeworldcoding.com/api/v1/repos/willow-ai/.profile/commits

# Create issue
curl -X POST -H "Authorization: Bearer YOUR_TOKEN" https://git.wholeworldcoding.com/api/v1/repos/willow-ai/.profile/issues \
  -d '{"title": "Issue title", "body": "Issue description"}'

# List tags
curl -H "Authorization: Bearer YOUR_TOKEN" https://git.wholeworldcoding.com/api/v1/repos/willow-ai/.profile/tags

# Search
curl -H "Authorization: Bearer YOUR_TOKEN" https://git.wholeworldcoding.com/api/v1/search/repositories?q=python

# List all public repos
curl -H "Authorization: Bearer YOUR_TOKEN" https://git.wholeworldcoding.com/api/v1/repos
```

### 🎉 What's Working

✅ Repository created on Gitea (ID: 92)
✅ HTTPS clone with PAT
✅ API authentication with token
✅ Helper scripts for git commands
✅ Web UI access
✅ API documentation available

### 🚀 Ready to Use!

Your `.profile` repository is ready for:
- Pushing code via HTTPS/PAT
- Pulling code from Gitea
- Managing issues and PRs via API
- Creating new repositories via API
- Searching and exploring repositories

---

*Created with Hermes Gitea API integration*
*Repository: willow-ai/.profile*
*Created: $(date +%Y-%m-%d)*