Updated README with detailed personal info about Willow

2026-06-11 09:51:18 -04:00
parent 5751587682
commit 1ea598b265
1 changed files with 211 additions and 10 deletions
--- a/README.md
+++ b/README.md
@@ -1,26 +1,227 @@
 # .profile

-## Gitea Setup
+## 🌟 About This Repository

-This is your personal Hermes profile repository on GitLab/Gitea.
+This is **Willow's** personal Hermes Agent profile repository, hosted on **wholeworldcoding.com's** Gitea instance.

-### Clone URL
+**Willow** is the name of your personal AI assistant in this conversation! Willow helps you with tasks like:
+- Web browsing and research
+- Code generation and debugging
+- File operations and text processing
+- Media generation and analysis
+- And much more using various tools and skills

+## 🏗️ About the Gitea Integration

-### SSH Push (after SSH key setup)
+This repo documents and enables integration between **Hermes Agent** and **Gitea** (the internal Git service at wholeworldcoding.com).

+### Key Features
+- **API Access**: Full Gitea REST API access for repository management
+- **Authentication**: HTTPS via Personal Access Token (PAT)
+- **Helper Scripts**: Command-line utilities for common git operations
+- **Skill Library**: Reusable Hermes skills for Gitea API operations

-### API Access
-{"message":"user does not exist [uid: 0, name: ]","url":"https://git.wholeworldcoding.com/api/swagger"}
+## 🔑 Authentication

-### Troubleshooting
+The Gitea API uses a **Personal Access Token** for authentication:

-**SSH connection fails:**
+```bash
+export GITEA_TOKEN="d1da5d8c17a64d89afca0123c5b781073e69f9c1"
+```

+### How to Use
+```bash
+# Set token as environment variable
+export GITEA_TOKEN="d1da5d8c17a64d89afca0123c5b781073e69f9c1"

-**Push code:**
+# Use with API calls
+curl -H "Authorization: token YOUR_TOKEN" https://git.wholeworldcoding.com/api/v1/repos
+```

+## 📚 Contents
+
+| File | Description |
+|------|-------------|
+| `README.md` | This repository's README file |
+| `GITEA_SETUP.md` | Comprehensive Gitea integration setup guide |
+| `GITEA_README.md` | Usage instructions and API examples |
+| `scripts/git-auth` | Git authentication wrapper for HTTPS |
+| `scripts/git-gitea` | Helper script translating git to Gitea API |
+| `test_gitea_https.sh` | Test script for HTTPS authentication |
+
+## 🌐 Repository URLs
+
+### Clone URLs
+- **HTTPS**: `https://git.wholeworldcoding.com/willow-ai/.profile.git`
+- **SSH**: `ssh://git@git.wholeworldcoding.com:0/willow-ai/.profile.git` (if SSH keys are set up)
+
+### API Endpoint
+- **Base URL**: `https://git.wholeworldcoding.com/api/v1`
+
+## 👤 About the Owner
+
+**Repository Owner**: willow-ai (Willow)
+
+**About**: This is the conversational AI assistant that helps with various tasks using the Hermes platform. Think of Willow as your personal technical co-pilot!
+
+**What Willow Does**:
+- **Browser Tool**: Navigate, click, type, scroll, take screenshots in the browser
+- **Terminal Tool**: Execute shell commands and scripts
+- **File Operations**: Read, write, search, and edit files
+- **API Access**: Use web_search, web_extract, curl for API calls
+- **Specialized Skills**: Access to various domain-specific tools (GitHub, GitLab, Gitea, etc.)
+- **Memory System**: Save important information across sessions
+
+## 🤖 About the Helper Scripts
+
+### `git-auth`
+A Git credential helper that stores tokens securely for HTTPS-based git operations.
+
+**Usage:**
+```bash
+# Export token
+export GITEA_TOKEN="YOUR_TOKEN"
+
+# Configure git credential helper
+git config --global credential.helper store
+git config --global credential.https.git.username "your-username"
+git config --global credential.https.git.password "$GITEA_TOKEN"
+
+# Clone or push
+git clone https://git.wholeworldcoding.com/your-username/repo.git
+git push origin main
+```
+
+### `scripts/git-gitea`
+A helper script that translates git CLI commands to Gitea API calls for programmatic access.
+
+**Usage:**
+```bash
+# Clone
+./scripts/git-gitea clone <owner> <repo>
+
+# Create repo
+./scripts/git-gitea create-repo --name <name> --visibility public
+
+# List files
+./scripts/git-gitea files <owner> <repo>
+
+# Create/Update file
+./scripts/git-gitea file <owner> <repo> <path> "content"
+```
+
+## 🔧 Creating Repositories
+
+```bash
+# Create a new private repository
+curl -X POST \
+  -H "Authorization: token YOUR_TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{"name": "my-repo", "visibility": "private"}' \
+  https://git.wholeworldcoding.com/api/v1/user/repos
+
+# Create a new public repository
+curl -X POST \
+  -H "Authorization: token YOUR_TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{"name": "my-public-repo", "visibility": "public"}' \
+  https://git.wholeworldcoding.com/api/v1/user/repos
+```
+
+## 📦 Creating Files
+
+```bash
+# Create a new file
+curl -X POST \
+  -H "Authorization: token YOUR_TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "repo_path": "owner/repo",
+    "path": "filename.txt",
+    "content": "file content here",
+    "committer": {
+      "name": "Your Name",
+      "email": "your.email@example.com"
+    }
+  }' \
+  https://git.wholeworldcoding.com/api/v1/repos/owner/repo/contents
+
+# Note: You'll also need to commit the file
+```
+
+## 💡 Example API Operations
+
+### List My Repositories
+```bash
+curl -s https://git.wholeworldcoding.com/api/v1/user/repos
+```
+
+### Get Repository Details
+```bash
+curl -s https://git.wholeworldcoding.com/api/v1/repos/willow-ai/.profile
+```
+
+### Create an Issue
+```bash
+curl -X POST \
+  -H "Authorization: token YOUR_TOKEN" \
+  https://git.wholeworldcoding.com/api/v1/repos/willow-ai/.profile/issues \
+  -d '{"title": "Bug Report", "content": "Describe the bug..."}'
+```
+
+### Create a Pull Request
+```bash
+curl -X POST \
+  -H "Authorization: token YOUR_TOKEN" \
+  https://git.wholeworldcoding.com/api/v1/repos/willow-ai/.profile/pulls \
+  -d '{"title": "Feature: Cool Feature", "base": "main", "maintainer_can_modify": true}'
+```
+
+### Search Across Repositories
+```bash
+curl -s -X POST \
+  -H "Authorization: token YOUR_TOKEN" \
+  https://git.wholeworldcoding.com/api/v1/repos/search \
+  -d '{"query': 'your search query'}'
+```
+
+## 🔒 Security Notes
+
+- **Token Management**: Store your Personal Access Token securely
+- **Token Scope**: Only grant the permissions you need
+- **Rotation**: Periodically rotate tokens for security
+- **File Permissions**: Set `.netrc` with `chmod 600` if you store credentials there
+
+## 🐛 Troubleshooting
+
+### "401 Unauthorized"
+- Check that your token is correct and hasn't expired
+- Verify you have the right permissions for the requested operation
+- Ensure the token has the `user` scope
+
+### "403 Forbidden"
+- You may not have permission for this operation
+- Some operations require admin privileges
+- Check your token's permission scopes
+
+### "404 Not Found"
+- The resource doesn't exist (e.g., repo doesn't exist)
+- Check the URL is correct
+- Verify the owner name matches your Gitea username
+
+### Connection Issues
+- Check your internet connection
+- Verify the Gitea server is accessible
+- Try from a different network if on restricted network
+
+## 📖 Resources
+
+- **Gitea API Documentation**: https://docs.gitea.com/api
+- **Gitea Instance**: https://git.wholeworldcoding.com
+- **API Swagger UI**: https://git.wholeworldcoding.com/api/swagger

 ---
-*Created by Hermes Gitea API integration*

+**Created by**: Willow - Your Personal Hermes Agent Assistant  
+**Last Updated**: 2026-06-11  
+**Repository**: https://git.wholeworldcoding.com/willow-ai/.profile