Files

T

michael 0461c6c7ab Add .gitignore and pyproject.toml (#1 )

### Findings and Changes

#### Changes:
- **Added **: Included a standard Python  to avoid tracking unnecessary files (e.g., , , ).
- **Added **: Prepared the project for better dependency management.
- **Enhanced Gitea Tools**:
    - Implemented  in .
    - Implemented  (via ) in .

#### Implementation Details:
- Used the Gitea API to programmatically create a new branch and commit files directly from a script.
- Verified that the NAME:
   tea - command line tool to interact with Gitea

USAGE:
   tea [global options] [command [command options]]

VERSION:
   Version: [1m0.14.1[0m  golang: 1.26.3  go-sdk: v0.25.1

DESCRIPTION:
   tea is a productivity helper for Gitea. It can be used to manage most entities on
   one or multiple Gitea instances & provides local helpers like 'tea pr checkout'.

   tea tries to make use of context provided by the repository in $PWD if available.
   tea works best in a upstream/fork workflow, when the local main branch tracks the
   upstream repo. tea assumes that local git state is published on the remote before
   doing operations with tea.    Configuration is persisted in $XDG_CONFIG_HOME/tea.

COMMANDS:
   help, h  Shows a list of commands or help for one command

   ENTITIES:
     issues, issue, i                  List, create and update issues
     pulls, pull, pr                   Manage and checkout pull requests
     labels, label                     Manage issue labels
     milestones, milestone, ms         List and create milestones
     releases, release, r              Manage releases
     times, time, t                    Operate on tracked times of a repository's issues & pulls
     organizations, organization, org  List, create, delete organizations
     repos, repo                       Manage repositories
     branches, branch, b               Consult branches
     actions, action                   Manage repository actions
     webhooks, webhook, hooks, hook    Manage webhooks
     comment, c                        Add a comment to an issue / pr

   HELPERS:
     open, o                         Open something of the repository in web browser
     notifications, notification, n  Show notifications
     clone, C                        Clone a repository locally
     api                             Make an authenticated API request

   MISCELLANEOUS:
     whoami    Show current logged in user
     admin, a  Operations requiring admin access on the Gitea instance

   SETUP:
     logins, login      Log in to a Gitea server
     logout             Log out from a Gitea server
     ssh-keys, ssh-key  Manage SSH public keys

GLOBAL OPTIONS:
   --debug, --vvv  Enable debug mode
   --help, -h      show help
   --version, -v   print the version CLI can be used for automated PR creation.
- Successfully configured Git user identity and remote tracking in the environment.

---------

Co-authored-by: Michael <michael@example.com>
Reviewed-on: #1

2026-06-28 18:38:28 +02:00

1.9 KiB

Raw Blame History

Web Search Skill

Purpose

Enable the agent to search the web using a self-hosted SearXNG instance for privacy-respecting searches.

Configuration

SearXNG Instance: https://searxng.meeks.freeddns.org
API Endpoint: /search
Supported Formats: json, csv, rss

Usage

Search the Web

When you need to look up information, find recent developments, or verify facts:

search_web(query="what is the latest version of Python", limit=10, language="en")

Parameters

query (required): The search query string
limit (optional): Number of results to return (default: 10, max: 100)
language (optional): Language code (e.g., "en", "sv", "de")
time_range (optional): Time filter - "day", "month", or "year"
categories (optional): Search category - "general", "images", "news", "videos", "science", "it", "music", "files", "map", "realtime"

Example Queries

search_web(query="uv python package manager tutorial")
search_web(query="searxng API documentation", time_range="month")
search_web(query="gitea vs github", categories="general")

Implementation Details

The skill uses the SearXNG JSON API:

GET https://searxng.meeks.freeddns.org/search?q={query}&format=json&limit={limit}&language={language}

Error Handling

If the SearXNG instance is unreachable, log the error and try alternative search methods
If the response format is invalid, parse what's available and report the issue
If rate limited, wait and retry with exponential backoff

When to Use

Researching technical issues or solutions
Looking up recent software updates or versions
Finding documentation or tutorials
Verifying facts or current information
Investigating error messages or stack traces
Finding similar projects or libraries

When NOT to Use

When you already have the information locally
For simple factual questions that don't require current data
When the user explicitly asks not to search the web

1.9 KiB Raw Blame History